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PREFACE 


This manual describes the resident Operating System (OS) for the 
ATART@ Home Computer, for readers who are familiar with the 
internal behavior of the system. It discusses: 


o System functions and utilization techniques 
o Subsystem relationships and organization 


's) Characteristics of the ATARI peripheral devices that can 
be attached to the ATARI400CTM] and ATARI SOOLCTM] Home 


Computer 


0 Advanced techniques for going beyond the basic OS 
capabilities 


0 The general features of the computer system hardware used 
by the OS. 


It would be helpful to have a familiarity with programming concepts 
and terminology, assembly language programming in general, the 
Synertek 6502 in particular, and digital hardware concepts and 
terminology. you will be provided with the information you need to 
use the OS resources, without resorting to trial-and-error techniques 
or the OS listing. Supporting information for tasks that involve OS 
listing references is also provided. 


This manual does not present a comprehensive description of the 
hardware used to provide OS capabilites. The programmer who needs to 
go beyond the capabilities described should consult the ATARI Home 
Computer Hardware Manual. 
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1.) INTRODUCTION 


GENERAL DESCRIPTION OF THE ATARI HOME COMPUTER SYSTEM 


Operating systems in the ATARI@ 400CTM] and ATARI SCOLTM] Home 
Computer are identical. The primary differences between the two are: 


0 


0 


Physical packaging 


The ATARI 400 Computer console has one cartridge slot, the 
ATARI 800 Computer console has two cartridge slots 


The ATARI 400 Home Computer contains 16K RAM and cannot be 
expanded. The ATARI 800 Home Computer can be expanded to a 
maximum of 48K RAM. 


The ATARI SOO Computer has a monitor jacki the ATARI 400 
Computer does not. 


The Hardware Circuitry 


o Produces both character and point graphics for black and 


white (B/W) or color television. 


o Produces four independent audio channels (frequency 


controlled) which use the television sound system. 


o Provides one bi-level audio output in the base unit. 


o Interfaces with up to four Joysticks and eight Paddle 


Controllers. 


o Interfaces with a serial I/0 bus for expansion. 


o Contains a built-in keyboard 


Figure 1-1 presents a simplified block diagram of the hardware. 
See the hardware manual for supporting documentation. 
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ATARI Home Computer Block Diagram 


Figure i-1. 


CONVENTIONS USED IN THIS MANUAL 

This manual uses the following special notations: 

Hexadecimal Numbers 

All two-digit numbers preceded by a dollar sign (%) designate 
hexadecimal numbers. All other numbers (except memory addresses) 
are in decimal form unless otherwise specified in the supporting 
text. 


Memory Addresses 


All references to computer memory and mapped I/0 locations are in 
hexadecimal notation. Memory addresses may or may not be contained 
in square brackets. (Example: CD2O0F] and D2OF are the same 
address. ) 


Kilobytes of Memory 

Memory sizes are frequently expressed in units of kilobytes, such 
as 32K, where a kilobyte is 1024 bytes of memory. 

PASCAL As an Algorithm-Specification Language 

The PASCAL language (procedure block only) is used as the 
specification language in the few places where an algorithm is 
specified in detail. PASCAL syntax is similar to any number of 
other block-structured languages, and you should have no 
difficulty following the code presented. 


Memory Layouts 


Diagrams similar to Figure 1-2 are used whenever pictures of bytes 
or tables are presented: 


7654321 0 


~~~ This is a block of memory 
of unspecified length. 


scents stents stented anaes steeds ceente, aoe 
i i ~~~ This is a single byte. 
Sheets steele steels Mele Reet ates steeds seals a 
{ 8 
$ t 
+ + --~- This is a word (2 bytes). 
H H 
Siete seats sleet seats seeds ated tee ea 
a & 
g « 
4 
t 


an 


s slesis creeds en Senate die ats ste eta 


Figure i-2. Memory Layout Chart 
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Bit 7 is the most significant bit (MSB) of the byte, and Bit O 
is the least significant bit (LSB). 


In tables and figures, memory addresses always increase toward the 
bottom of the figure. 
Backus-Naur Form 


A modified version of Backus-Naur Form (BNF) is used to express some 
syntactic forms, where the following metalinguistic symbols are used: 


Dis is the substitution (assignment) operator. 
< >? a metasyntactic variable. 

H separates alternative substitutions. 

Cc j an optional construct. 


Anything else is a syntactic literal constant, which stands for 
itself. 


For Example: 
<device specification> ::= <device name>f<device number]: 
<device name> ::= CIDIEtKiPiRis 


<device number> ::= Li2iai4iSiai7is 


A “device specification“ consists of a mandatory “device name, “ 
followed by an optional “device number." followed by the mandatory 
colon character. The device name in turn must be one of the 
characters shown as alternatives. The device number (if it is present) 
must be a digit 1 through 8. 


OS Equate Filenames 


Operating System ROM (Read Only Memory? and RAM (Random Access 
Memory} vector names, RAM database variable names and hardware 
register names are all referred to by the names assigned in the OS 
program equate list. When one of these names is used, the memory 
address is usually provided, such as BOOTAD [0242]. 
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2 OPERATING SYSTEM FUNCTIONAL ORGANIZATION 


This section describes the various subsystems of the resident OS in 
general terms. 


Input/Output Subsystem 


The Input/Output (1/03 subsystem provides a high-level interface 
between the programs and the hardware. Most functions are 
device-independent, such as the reading and writing of character data: 
yet provisions have been made for device-dependent functions as well. 
All peripheral devices capable of dealing with character data have 
individual symbolic names (such as K,D,P, etc). and can be accessed 
using a Central I/0 (CIO) routine. 


A RAM data base provides access to controllers (yoysticks and paddle 
controllers}. which do not deal with character data. This RAM data 
base is periodically updated to show the states of these devices. 


INTERRUPT PROCESSING 


The interrupt system handles all hardware interrupts in a common 
and consistent manner. By default, all interrupts are fielded by 
the OS. At your discretion, individual interrupts (or 

groups of interrupts}? can be fielded by the application program. 


INITIALIZATION 


The system provides two levels of initialization: power up and 
system reset. The OS performs power-up initialization each time 
the system power is switched to ON, and system reset 
initialization is performed each time the CSYSTEM. RESET] key is 
pressed. 


Power-—Up 
The OS examines and notes the configuration of the unit whenever 


the system power is switched to ON. The system performs the following 
tasks at power up: 
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0 Determines the highest RAM address. 

0 Clears all of RAM to zeros. 

0 Establishes all RAM interrupt vectors. 
0 Formats the device table. 


o Initializes the cartridges}. 


a Sets up the screen for 24 x 40 text mode. 
o Boots the cassette if directed. 
3) Checks cartridge slot(s) for diskette-boot instructions. 


o Boots the diskette if directed to do so and a disk drive unit 
is attached. 


o Transfers control to the cartridge, diskette-booted program, 
cassette-booted program, or blackboard program. 

CSYSTEM. RESET] 
Pressing the CSYSTEM. RESET] key causes the OS to perform these 
following tasks: 

o Clears the OS portion of RAM. 

o Rechecks top of RAM. 

0 Reestablishes all RAM interrupt vectors. 

o Formats the device table. 

o Initializes the cartridge(s). 

o Sets up the screen for 24 x 40 text mode. 


o Transfers control to the cartridge, a diskette-booted program, 
a cassette-booted program, or the blackboard program. 


Note that CSYSTEM. RESET] does not perform all the power-up 
tasks Listed in the power-up section. 
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FLOATING POINT ARITHMETIC PACKAGE 


The OS ROM contains a Floating Point (FP) package that is available 
to nonresident programs such as ATARI BASIC. 


The package is not used by the other parts of the OS itself. 


The 


floating point numbers are stored as 10 BCD digits of mantissa, 
i-byte exponent. The package contains these routines: 


24 


Qa 


0 


7) 


ASCII-to-FP and FP-to-ASCII conversion. 
Integer-to-FP and FP-to-integer conversion. 
FP add. subtract, multiply and divide. 

FP log. exp, and polynomial evaluation. 


FP number clear, load, store: and move. 


OPERATING SYSTEM CO16555 -- Section 2 


plus a 


3 CONFIGURATIONS 


The ATARI 400 and ATARI G00 Home Computers support a 
wide variety of configurations, each with a unique operating 
environment: 


o Cartridge(s) may or may not be inserted 


go Memory can be optionally added to the ATARI 800 Computer 
console in 16K increments 


o Many different peripheral devices can be attached to the 
serial I/0 bus. 


The OS accounts for all of these variables without requiring a 
change in the resident OS itself (see Section 2). The machine 
configuration is checked when power is first turned on and then 
is not checked again, unless system reset is used. A general 
discussion of some of the valid configurations follows. 


PROGRAM ENVIRONMENTS 


The OS allows one of four program types to be in control at any 
point in time: 


o The OS blackboard (ATARI Memo Pad) program 

o A cartridge-resident program 

o A diskette-booted program 

o A cassette-booted program 
Control choice is based upon information in the cartridge(s)}, upon 
whether or not a disk drive is attached, and upon operator keyboard 
inputs. The exact algorithms are discussed in detail in Section 7. 
Blackboard Mode 
In blackboard mode, the screen is established as a 24 x 40 text 
screen. Anything entered from the keyboard goes to the screen 
without being examined, although all of the screen editing 
functions are supported. Blackboard mode is the lowest priority 


environment. You go there only by command from a higher 
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priority environment, or by default, if there is no other 
reasonable environment for the OS to enter. For example, typing BYE 
in BASIC causes the OS to enter the blackboard mode. The blackboard 
mode can be exited by pressing the CSYSTEM. RESET] key if it was 
entered from a higher environment. 


Cartridge 


An inserted cartridge normally provides the main control after 
initialization is complete (for example: ATARI BASIC, SUPER 
BREAKOUTCTM], BASKETBALL, COMPUTER CHESS, and others. All these 
cartridge programs interface directly with you in some way). Although 
a cartridge can provide a supporting function for some other program 
environment. this has not yet been done. Some cartridges (particularly 
keyboard-oriented ones) can change environments by entering special 
commands (such as “BYE"}) to go to blackboard mode or "DOS" to enter 
the disk utility. Other cartridges cannot change environments. Note 
that a hardware interlock prevents the removal or insertion of a 
cartridge with the power on; this feature causes the entire system to 
reinitialize with every cartridge change. 


Diskette Boot 


The diskette may or may not be booted when the system powers up 
with diskette-bootable software. This paragraph assumes that a 
diskette boot did occur. See Section 7 for boot condition 
explanations. 


The diskette-booted software can take control as the Disk Utility 
Program (DUP) does under certain conditions, or can provide a 
supporting function as the File Management System (FMS) does. This 
environment is so flexible that it is difficult to generalize on its 
capabilities and restrictions. The only machine requirement (other 
than the disk drive} is that sufficient RAM be installed to support 
the program being booted. 


Cassette-Boot 


The cassette-boot environment is similar to the diskette-boot 
environment, although the cassette is limited as an I/0 device. It 
is slow and can access only one file at a time in sequence. Note 
that the cassette-boot facility has no relation to the use of 
cassettes to store high-level language programs (e.g., programs 
written in ATARI BASIC). nor to the use of cassettes to store data. 
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RAM EXPANSION 


Although you can expand RAM noncontiguously in the 

ATARI 800 Home Computer, the OS will only recognize RAM 

that is contiguous starting from location O. Installation 
directions are provided with the purchased RAM modules. RAM can be 
added until it totals 48K. After S2Kh. additional RAM overlays first 
the right-cartridge addresses (32K to 40K} and then the 
left-cartridge addresses (40K to 48K). Note that in cases of 
conflict, the inserted cartridge has higher priority and disables 
the conflicting RAM in SK increments. See Section 4 for a detailed 
discussion of system memory. 


As a result of power-up, the OS will generate two pointers that 
define the lowest available RAM location and the highest available 
RAM location. The OS and diskette or cassette-booted software will 
determine the location of the lowest available RAM. while the 
number of RAM modules and the current screen mode will determine 
the highest available RAM. 


PERIPHERAL DEVICES 


Peripheral devices of several types can be added to the system 
using standard cables to either the serial bus or the connectors at 
the front of the computer console. The most common types deal with 
either transmission of bytes of data (usually serial bus) or 
transmission of sense information (usually game controllers). 


Game Controllers 


The OS periodically senses (50 or 60 times per second) the standard 
game controllers (Paddles and Joysticks) and the values read are 
stored in RAM. You can plug ins remove, and rearrange these 
controllers at will without affecting system operation, because the 
system will always try to read all of these controllers. 

The Driving Controllers are read, but not decoded, by the OS. Special 


instructions are required to read the keyboard controller (see 
Section i1}. 


Program Recorder 


The ATARI 410CTM] Program Recorder is a special peripheral. It uses 
the serial bus to send and receive data, but does not conform to 
the protocol of the other peripherals that use the serial bus. The 
Program Recorder must also be the last device on the serial bus, 
because it does not have a serial bus extender connector as the 
other peripherals do. There can never be more than one Program 
Recorder connected to any system for the same reason. The system 
cannot sense the presence or absence of the Program Recorder, so it 
can be connected and disconnected at will. 
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Serial Bus Devices 


A serial bus device conforms to the serial I/O bus protocol as 
defined in Section 9, but this does not include the Program 
Recorder. Each serial bus device has two identical connectors: a 
serial bus input, and a serial bus extender. Either connector can 
be used for either purpose. Peripherals can be “daisychained" by 
cabling them together in a sequential fashion. There are usually no 
restrictions on the cabling order because each device has a unique 


identifier. Where restrictions exist, they will be mentioned in 
Section 5. 
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4 SYSTEM MEMORY UTILIZATION 


Memory in the system is decoded in the full 64K range of the 6502 
microcomputer and there are no provisions for additional mapping to 
extend memory. Memory is divided into four basic regions (with some 
overlap possible}: RAM. cartridge area, I[/0 region and the resident 
OS ROM. The regions and their address boundaries are listed below 
(all addresses are in hexadecimal): 


OOCCO-1FFF = RAM (minimum required for operation) 

2000-7FFF = RAM expansion area 

SOCO-SFFF = Cartridge B. Cartridge A (half of 16K size) or RAM 
ACOQ-BFFF = Cartridge A or RAM 

COOC-CFFF = Unused 

DOCOC-D7FF = Hardware I/0 decodes 

DSOO-DFFF = Floating Point Package (05S) 

EOCG=FFFF = Resident Operating System ROM 


Figure 4-1 6502 System Memory Map 


This section will break these regions into even smaller functional 
divisions and provide detailed explanations of their usage. 


RAM REGION 


The OS and the control program share the RAM region. The RAM region 
can be further subdivided into the following sub regions for 
discussion purposes: 


Page GO = 6502 page zero address mode region. 
Page i = 6502 stack region. 

Pages 2-4 = 0S database and user workspace. 

Pages S-46& = User program workspace. 

Pages 7-XX = Bootable software area/free RAM. + 

Pages XX-top of RAM = Screen display list and data. * 


*% Note that XX is a function of the screen graphics mode and the 
amount of RAM installed. 


The paragraphs that follow describe how the OS uses RAM subregions, 
and presents user program recomendations. 
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Page 0 


The architecture of the 6502 microcomputer instruction set and 
addressing modes gives page 0 special significance. References to 
addresses in that page (0000 to OOFF) are faster, require fewer 
instruction bytes, and provide the only mechanism for hardware 
indirect addressing. Page © should be used sparingly so that all 
possible users can have a portion of it. The OS permanently takes the 
lower half of page O (0000 to OO7F). This portion can never be used by 
any outer environment unless the OS is completely disabled and all 
interrupts to the OS are eliminated. 


The upper half of page O (0080 to OOFF) is available to outer 
environments with the following restriction: the floating point 
package, if used, requires OOD4 through OOFF. 


Page 1 


Page 1 is the 46502 hardware stack region; JSR instructions, PHA 
instructions, and interrupts all cause data bytes to be written to 
page 1. Conversely RTS. PLA, and RTI instructions all cause data bytes 
to be read from page 1. The 256 byte stack is adequate for normal 
subroutine calls plus interrupt process nesting, so no restrictions 
have been made on page 1 usage. It is obvious that a stack of this 
size is totally inadequate for deeply recursive processes or for 
nested processes with large local environments to be saved. So, for 
sophisticated applications, software maintained stacks must be 
implemented. 


The 6502 stack pointer is initialized at power-up or system reset to 
point to location O1FF. The stack then pushes downward toward 0100. 
The stack will wrap around from 6100 to OFF if a stack overflou 
condition occurs, because of the nature of the 6502's G-bit stack 
pointer register. 


OS Data Base 


Locations G2C00 through O47F are allocated by the OS for working 
variables, tables and data buffers. Portions of this region can be 
used only after you determine that nonconflict with the OS 

is guaranteed. For example, the printer and cassette buffers could be 
used if I/O operations to these devices are impossible within the 
controlling environment. The amount of work involved in determining 
nonconflict seems to be completely out of line with the benefits to be 
gained (except for a few trivial cases) and it is recommended that 
pages 2 through 4 not be used except by the OS. 
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User Workspace 


Locations O0480 through OO6FF are dedicated for outer environment use 
except when the floating point package is used. The floating point 
package uses locations OS7E through OSFF. 


Boot Region 


Page 7 is the start of the “boot region.“ When software is booted from 
either the diskette or the cassette, it can start at the lowest free 
memory address (that is 0700) and proceed upward (although it can also 
start at any address above 0700 and below the screen display list). 
The top of this region defines the start of the “free memory" region. 
When the boot process is complete, a pointer in the data base contains 
the address of the next available location above the software just 


booted. When no software has been booted, this pointer contains the 
value 0700. 


Screen Display List and Data 


When the 0S is handling the screen display. the display list that 
defines the screen characteristics and the current data that is 
contained on the screen are placed at the high address end of RAM. The 
bottom of this region defines the end of the free memory region and 
its location is a function of the screen mode currently in effect. A 
pointer in the data base contains the address of the last available 
location below the screen region. 


Free Memory Region 


The free memory region is all the RAM between the end of the boot 
Tegion and the start of the screen region. The outer level application 
is responsible for managing the free memory region. 


CARTRIDGES A AND B 


There are two SK regions reserved for plug-in cartridges. Cartridge B, 
that is the right-hand cartridge slot found only in the ATARI 800 
Home Computer, has been allocated memory addresses 8000 

through SFFF. Cartridge A (the left-hand cartridge slot in the ATARI 
SCO Computer console, and the only slot in the ATARI 400 Computer 
console} has been allocated memory addresses AQOO through BFFF and 
optionally S000 through BFFF, for 14K cartridges. If a RAM module is 
plugged into the last slot such as to overlay any of these addresses, 
the RAM takes precedence as long as a cartridge is not inserted. 
However, if a cartridge is inserted, it will disable the entire 
conflicting RAM module in the last slot in 8K increments. 
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MAPPED 1/0 


The 6502 performs input/output operations by addressing the external 
support chips as memory: some chip registers are read/write while 
others are read-only or write-only (the ATARI Home Computer 

Hardware Manual gives descriptions of all of the external Tegisters). 
While the entire address space from DOOG to D7FF has been allocated 
for I/0 decoding, only the following subregions are used: 


DOCO-DOIF = CTIA 
D200-D2iF = POKEY 
D300-D31F = PIA 

D400-D41iF = ANTIC 


Figure 4-2. Mapped I/0 


RESIDENT OS AND FLOATING POINT PACKAGE ROM 


The region from D800 through FFFF always contains the OS and the 
floating point package. Care should be taken to avoid using any entry 
points that are not guaranteed not to move, to allow for the 
possibility that another, but functionally compatible, OS can be 
generated in the future. The OS contains many vectored entry points at 
the end of the ROM and in RAM that will not move. The floating point 
package is not vectored, but all documented entry points will be 
fixed: Do not use undocumented routines found by scanning the listing. 
A list of the fixed ROM vectors can be found in Appendix J. 


CENTRAL DATA BASE DESCRIPTION 


See Appendix L. 


MEMORY DYNAMICS 


The free memory region is the area between the end of the boot region 
and the start of the screen region. As such, its limits are variable. 
MEMLO CO2ZE7] defines the bottom of the free region, and MEMTOP [CO2E5) 
defines the top of the region. This section presents the conditions 
that cause the setup or alteration of these variables. 
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System Initialization Process 


The OS determines the extent of the lowest block of contiguous RAM, 
and saves the limits. The Screen Editor is then opened, thus setting a 
new (and lower} value in MEMTOP. Diskette or cassette-booted software 
might be brought into memory, that would probably set a new (and 
higher} value in MEMLO (see Section 7). MEMLO and MEMTOP will define 
the maximum amount of free memory available when the application 
program finally gets control. That amount of free memory can later 
decrease, as described in the next paragraph. 


Changing Screen Modes 


The Display Handler interprets the variable APPMHI ‘COOQOE]’ to contain 
the address below which MEMTOP cannot extend. This allows you to 
protect the portion of free memory space that you are using from being 
overwritten as a result of screen mode change. The display handler 
will set the screen for mode 0. update MEMTOP, and return an error 
status to you, if it determines that the screen memory will 

extend below APPMHI as a result of a screen mode change. In other 


cases the Display Handler effects the desired mode change and updates 
MEMTOP. 
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5 1/0 SUBSYSTEM 


This section discusses the 1/0 subsystem of the Operating System. The 
I/O subsystem comprises a collection of routines that allow you 

to access peripheral and local devices at three different levels. The 
CIO (Central I/0 Utility), provides the highest level, device 
independent access to devices. The second level allows communication 
with the device handlers. The lowest level is the SIO (Serial I/D bus 
Utility) routine. Any lower level access to a device involves the 
direct reading and writing of the hardware registers associated with 
the device. 


The data byte is the basic unit of input/output. A data byte can 
contain either “binary" (non text) information, or encoded text 
information. The text encoding scheme supported by the OS is called 
ATASCII., derived from the words "ATARI ASCII." Most ATASCII codes are 
the same as ASCII, with the primary deviations being the control 
codes. Appendix D shows the ATASCII character set, and Appendices E, 
F, and G show device-specific implementations for the display, 
keyboard, and printer. 


The structure of the 1/0 subsystem is shown on the following page. 
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Where: 


shows a control path. ##+## shows the data structure 
required for a path. 


Note the following: 


Oo 


Figure 


The 
The 


The 


Keyboard/Display/Screen Editor Handlers don’t use SIO. 
Diskette handler cannot be called directly from CIO. 
DCB is shown twice in the diagram. 


1/0 Subsystem Structure Flow Diagram 
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CENTRAL I/O UTILITY 


The Central I/O Utility provides you with a single interface in which 
to access all of the system peripheral devices in a device-independent 
manner. The minimum unit of data transfer is the data byte. The CIO 
also supports multiple byte transfers. All I/O operations are 
performed on a “return-to-user-when-complete" basis; there is no way 
to initiate concurrent “overlapped" I/O processes. 


I/O is organized by "files," where a file is a sequential 
collection of data bytes. A file can or may not contain textual 
data and it can or may not be organized by “records, " where a 
record is a contiguous group of bytes terminated by an EOL (End of 
Lined character. Some files are synonymous with a device (as with 
the printer and the Screen Editor), while other devices can contain 
multiple files, each with a unique name (as with the disk drive). 


CIO allows you to access up to eight independent device/files 
at one time, because there are eight I/0 Control Blocks (IOCB’s) in 
the system. Each of the IOCB’s can be assigned to control any 
device/file because there are no preferred assignments, except that 


IOCB #0 is assigned to the Screen Editor at power-up and 
system reset. 


To access a peripheral. you first set up an IOCB for the OPEN 
command, that supplies the system name for the device to be 
accessed (e.g. K:, for the keyboard, P:, for the printer, D: STARS 
for a diskette file mamed ‘STARS’, etc). You then call the CIO, 
telling it to examine the IOCB to find the OPEN information. CIO 
attempts to find the specified device/file and returns a status 
byte indicating the success of the search. If the specified 
device/file can be found by CIO. then CIO stores control 


information in the IOCB. The IOCB is now used for as long as that 
file is open. 


Once a file is open, it can then be accessed using data-read or 
data-write types of commands: in general, Treading can proceed until 
there is mo more data to read (End of File) and writing can proceed 
until there is no more medium to store data on (End of Medium), 
although neither reading nor writing need proceed to that point. 
The reading and writing of data generally occurs into and out of 
user-supplied data buffers (although a special case allowing single 
byte transfers using the 6502 A register is provided>. 


When there are no more accesses to be performed on an open 
device/file, you perform the close operation. This 
accomplishes two functions: 


0 It terminates and makes permanent an output file (essential 
for diskette and cassette). 


0 It releases that IOCB to be used for another I/0 operation. 
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CIO Design Philosophy 


The CIO utility was designed specifically to meet the following 
design criteria. 


o The transfer of data is device independent. 

o Byte-at-a-time, multiple byte and record-aligned accesses are 
supported. 

o Multiple device/files can be accessed concurrently. 


's) Error handling is largely device independent. 


o New device handlers can be added without altering the system 
ROM. 


Device Independence 


CIO provides device independence by having a single entry point for 
all devices (and for all operations?) and by having a 
device-independent calling sequence. Once a device/file is opened, 
data transfers occur with no regard to the actual device involved. 
Uniform rules for handling byte- and record-oriented data transfers 
allow the actual device storage block sizes to be transparent to you. 


Data Access Methods 


The CIO supports two file access methods: byte-aligned and 
record-aligned. 


Byte-aligned accesses allow you to treat the device/file as a 
sequential byte streami any number of bytes can be read or written 
and the following operation will continve where the prior one left 
off. Records are of no consequence in this mode. and reads or 
writes can encompass multiple records if desired. 


Record-aligned accesses allow you to deal with the data stream 

at a higher level, that of the data record or “Line of text." Each 
and every write operation creates a single record (by definition?>. 
Each read operation assures that the following read operation 

will start at the beginning of a record. Record-aligned accesses 
cannot deal with portions of more than one record at a time. 
Record-aligned accesses are useful only with text data or with 
binary data guaranteed not to contain the EOL character ($9B) as 
data. 


Note that any file can be accessed using the byte-aligned access 
method, regardless of how the file was created. But not all files 
can be successfully read using record-aligned accessesi the file 
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must contain EOL characters at the end of each record and at no 
other place. 


Multiple Device/File Concurrency 


Up to eight device/files can be accessed concurrently using CIO, 
each operating independently of the others. 


Unified Error Handling 


All error detection and recovery occurs within the CIO subsystem. 
The status information that reaches you is in the form of a 
status byte for each device/file. Error codes are device 
independent as much as possible (see Appendix B}. 


Device Expansion 


Devices are known by single character names such as K or P, and a 
number of device handlers are part of the resident system ROM. 
However, additional device handlers can be added to the system 
using the RAM-resident device table; this is normally done at 
power-up time as with the diskette boot process, but can be done at 
any point in time. 


CIO Calling Mechanism 


The input/output control block (IOCB) is the primary parameter 
passing structure between you and CIO. There are eight IOCB’s 
in the system, arranged linearly in RAM as shown below: 


5 Aah ae + low address [0340] 


apenas eony eee + high address 


Figure 5-2 CIO Calling Mechanism 
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One IOCB is required for each open device/file. Any IOCB can be used 
to control any device/file, although IOCB O is normally assigned to 
the Screen Editor (E:). You perform a typical 1/0 operation by: 


9 Inserting appropriate parameters into an IOCB of your choosing 
o Putting the IOCB number times 16 into the 6502 X register 
o Performing a JSR to the CIO entry point CIOV CE456]. 


CIO returns to you when the operation is complete or if an 

error was encountered. The operation status is in the IOCB used, as 
well as in the 6502 Y register. The 6502 condition codes will also 
reflect the value in the Y register. In some cases a data byte will 
be in the 6502 A register. The X register will remain unchanged for 


all operations and conditions. An example is shown below: 
IOCB2X = $20 i INDEX FOR IOCB #€2. 
iDX #IOCB2X 
JSR CIOV 
CPY #0 i Coptional>? 
BMI ERROR 


This sector describes each IOCB byte, with its file name and 
address. Each I0CB is 16 bytes long. Some bytes can be altered by 


you and some are reserved for use by CIO and/or the device 
handlers. 


Handler ID ~- ICHID £0340] 


The handler ID is an index into the system device table (see 
Section 9) and is not user-alterable. This byte is set by CIO as 
the result of an OPEN command and is left unchanged until the 
device/file is closed, at that time CIO will set the byte to FF. 


Device Number -- ICDNO [0341] 


The device number is provided by CIO as the result of an OPEN 
command and is not user-alterable. This byte is used to 


distinguish between multiple devices of the same type. such as 
D1: and Da:. 
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Command Byte -~ ICCMD [0342] 


You set the command byte. It specifies the command to be 
performed by the CIO. This byte is not altered by CIO. 


Status -- ICSTA [0343] 


The CIO conveys operation status to you with the command 

status byte as a result of each and every CIO call. Each and 
every CIO call updates the command status byte. The most 
Significant (sign) bit is a one for error conditions and zero for 
non-error conditions, and the remaining bits represent an error 
number. See Appendix B for a list of status codes. 


Buffer Address -- ICBAL [£0344] and ICBAH [0345] 


You set this 2-byte pointer; it is not altered by CIO. The 


pointer contains the address of the beginning (low address) of a 
buffer that: 


o Contains data for read and write operations 


o Contains the device/filename specification for the OPEN 
cammand. 


You can alter the pointer at any time. 


PUT Address -- ICPTL £0346] and ICPTH [0347] 


The CIO sets this 2-byte pointer at OPEN time to the handler’s 
PUT CHARACTER entry point (- 1). The pointer was provided to 
accommodate the people writing the ATARI BASIC cartridge, and has 
no legitimate use in the system. This variable is set to point to 


CIO’s “IOCB not OPEN" routine on CLOSE, Power-up and 
CSYSTEM. RESET}. 


Buffer Length/Byte Count -- ICBLL [0348] and ICBLH £0349] 


You set this 2-byte count to indicate the size of the data 

buffer pointed to by ICBAL and ICBAH for read and write 
operations. It is not required for OPEN. After each read or write 
operation, CIO will set this parameter to the number of bytes 
actually transferred into or out of the data buffer. For 
record-aligned access, the record length can well be less than 
the buffer length. Also an end of file condition or an error can 
cause the byte count to be less than the buffer length. 


Auxiliary Information -- ICAX1 CO34AJ] and ICAX2 [€034B] 
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You set these a-bytes. They contain information that is 
used by the OPEN command process and/or is device-dependent. 


For OPEN, two bits of ICAX1 are always used to specify the OPEN 
direction as shown below, where R is set to i for input (read) 
enable and W is set to 1 for output (write) enable. 


+—+ + 
t ’ 8 t 
| t t 8 
+—-+—-+— b+ 


ICAX1 is not altered by CIO. You should not alter ICAX1 
once the device/file is open. 


The remaining bits of ICAX1 and all of ICAX2 contain only 
device-dependent data and are explained later in this section. 


Remaining Bytes (ICAX3-ICAX4) 


The handler reserves the four remaining bytes for processing the 
I/O command for CIO. There is no fixed use for these bytes. They 
are not user-alterable except as specified by the particular 
device descriptions. These bytes will be referred to as ICAX3, 
ICAX4, ICAXS and ICAX6, although there are no equates for those 
names in the OS equate file. 


CIO Functions 


The CIO supports records and blocks and the handlers support 
Single bytes. All of the system handlers support one or more 
of the eight basic functions subyect to restrictions based 
upon the direction of data transfer (e.g. one cannot read data 
from the printer). The basic functions are: OPEN, CLOSE, GET 
CHARACTERS, PUT CHARACTERS. GET RECORD, PUT RECORD, GET STATUS, 
and SPECIAL. | 


OPEN -- Assign Device/Filename to IOCB and Ready for Access 


A device/file must be opened before it can be accessed. This 
process links a specific IOCB to the appropriate device 
handler, initializes the device/file, initializes all CIO 
control variables, and passes device-specific options to the 
device handler. 
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You set up the following IOCB parameters prior to calling CIO for an 
OPEN operation: 


COMMAND BYTE = $03 

BUFFER ADDRESS = pointer to a device/filename specification. 
AUX1 = OPEN direction bits, plus device-dependent information. 
AUX2 = device-dependent information. 


After an OPEN operation, CIO will have altered the following IOCB 
parameters: 


HANDLER ID = index to the system device tablei this is 
used only by CIO and must not be altered. 


DEVICE NUMBER = device number taken from the device/filename 
specification and must not be altered. 


STATUS = result of OPEN operation; see Appendix B for a list 
of the possible status codes. In general, a negative status 
will indicate a failure to open properly. 


PUT ADDRESS = pointer to the PUT CHARACTERS routine for the 
device handler just opened. 


It is recommended that this pointer not be used. 


CLOSE -~- Terminate Access to Device/File and Release IOCB. 

You issue a CLOSE command after you are through accessing a 
given device/file. The CLOSE process completes any pending data 
writes, goes to the device handler for any device-specific 
actions, and then releases the IOCB. 


You set the following IOCB parameter prior to calling 
Cio: 


COMMAND BYTE = #$0C 


The CIO alters the following IOCB parameters as a result of the 
CLOSE operation: 


HANDLER ID = $FF 
STATUS = Result of CLOSE operation. 


PUT ADDRESS = pointer to “IOCB not OPEN" routine. 
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GET CHARACTERS -- Read n Characters (Byte-Aligned Access)? 
The specified number of characters are read from the device/file 
to the user-supplied buffer. EOL characters have no termination 
features when using this function; there can be no EOL, or many 
EOL ’s. in the buffer after operation completion. There is a 
special case provided that passes a single byte of data in the 
6502 A register when the buffer length is set to zero. 
You set the following IOCB parameters prior to calling CIO: 
COMMAND BYTE = $07 
BUFFER ADDRESS = pointer to data buffer. 


BUFFER LENGTH = number of bytes to readi if this is zero, 
the data will be returned in the 4502 A register only. 


The CIO alters the following IOCB parameters as a result of the 
GET CHARACTERS operation: 


STATUS = result of GET CHARACTERS operation. 
BYTE COUNT/BUFFER LENGTH = number of bytes read to the 


buffer. The BYTE COUNT will always equal the BUFFER LENGTH 
except when an error or an end-of-file condition occurs. 


PUT CHARACTERS -- Write n Characters (Byte-Aligned Access} 
The specified number of characters are written from the user-supplied 
buffer to the device/file. EOL characters have no buffer 
terminating properties, although they have their standard meaning 
to the device/file receiving them: no EOL ’s are generated by CIO. 
There is a special case that allows a single character to be 


passed to CIO in the 6502 A register if the buffer length is 
zero. 


You set the following I0CB parameters prior to initiating the PUT 
CHARACTERS operation: 


COMMAND BYTE = $0B 
BUFFER ADDRESS = pointer to data buffer. 
BUFFER LENGTH = number of bytes of data in buffer. 


The CIO alters the following IOCB parameter as a result of the 
PUT CHARACTERS operation: 


STATUS = result of PUT CHARACTERS operation. 
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GET RECORD -- Read Up To n Characters (Record-Aligned Access)? 


Characters are read from the device/file to the user-supplied 
buffer until either the buffer is full or an EOL character is 
read and put into the buffer. If the buffer fills before an EOL 
is read, then the CIO continues reading characters from the 
device/file until an EOL is read,, and sets the status to 
indicate that a truncated record was read. No EOL will be put at 
the end of the buffer. 


You set the following IOCB parameters prior to calling CIO: 
COMMAND BYTE = $05 
BUFFER ADDRESS = pointer to data buffer. 


BUFFER LENGTH = maximum number of bytes to read (including 
the ENDL character). 


The CIO alters the following IOCB parameters as a result of the 
GET RECORD operation: 


STATUS = result of GET RECORD operation. 


BYTE COUNT/BUFFER LENGTH = number of bytes read to data 
buffer; this can be less than the maximum buffer length. 


PUT RECORD -~- Write Up To n Characters (Record-Aligned Access) 


Characters are written from the user-supplied buffer to the 
device/file until sither the buffer is empty or an EOL character 
is written. If the buffer is emptied without writing an EOL 
character to the device/file, then CIO will send an EOL after the 
last user-supplied character. 
You set the following IOCB parameters prior to calling CIO: 

COMMAND BYTE = $09 

BUFFER ADDRESS = pointer to data buffer. 

BUFFER LENGTH = maximum number of bytes in buffer. 


The CIO alters the following IOCB parameter as a result of the 
PUT RECORD operation: 


STATUS = result of PUT RECORD operation. 


OPERATING SYSTEM C016555 -- Section § 
44 


GET STATUS -- Return Device-Dependent Status Bytes 
The device controller is sent a STATUS command, and the 


controller returns four bytes of status information that are 
stored in DVSTAT [CO2EA]. 


You set the following IOCB parameters prior to calling CIO: 
COMMAND BYTE = $0D 


BUFFER ADDRESS = pointer to a device/filename specification 
if the IOCB is not already OPEN; see the discussion of the 
implied OPEN option below. 


After a GET STATUS operation, CIO will have altered the following 
parameters: 


STATUS = result of GET STATUS operation: see Appendix B for 
a list of the possible status codes. 


DVSTAT = the four-byte response from the device controller. 


SPECIAL -- Special Function 


Any command byte value greater than #O0D is treated by CIO as a 

special case. Since CIO does not know what the function is, Cio 
transfers control to the device handler for complete processing 
of the operation. 


The user sets the following IOCB parameters prior to 
calling CIO: 


COMMAND BYTE > $0OD 


BUFFER ADDRESS = pointer to a device/fileaname specification 
if the IOCB is not already openi see the discussion of the 
implied OPEN option below. 


Other IOCB bytes can be set up, depending upon the specific 
SPECIAL command being performed. 


After a SPECIAL operation, CIO will have altered the following 
parameters: 


STATUS = result of SPECIAL operation: see Appendix B for a 
list of the possible status codes. 


Other bytes can be altered, depending upon the specific 
SPECIAL command. 
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Implied OPEN Option 


The GET STATUS and SPECIAL commands are treated specially by CIO: 
they can use an already open IOQCB to initiate the process or they 
can use an unopened IOCB. If the IOCB is unopened, then the 
buffer address must contain a pointer to a device/filename 
specification. just as for the OPEN command: CIO will then open 
that IOCB, perform the specified command and then close the IOCB 
again. 


Device/Filename Specification 


As part of the OPEN command, the IOCB buffer address parameter 
points to a device/filename specification, that is a string of 
ATASCII characters in the following format: 


“specification> ::= <device>€<number>]: (<filename>I<eol> 


“device> ::= CiDIE:tKIiPiRiS 

<number> ::= Li2isi4isiai7is 

<filename> has device-dependent characteristics. 
<eol> ::= $9B 


The following devices are supported at this writing: 


C Cassette drive 

Di through D8 = Floppy diskette drives +# 
E = Screen Editor 

K = Keyboard 

P = 40-column printer 

P2 = 80-column printer + 

Ri through R4 = RS-232-C interfaces +# 

S = Screen display 


Devices flagged by asterisks (#) are supported by nonresident 
handlers. 


If <number> is not specified, it is assumed to be 1. 


The following examples show valid device/filename specifications: 


C: Cassette 
D2: BDAT File “BDAT" on disk drive #2 
D: HOLD File "HOLD" on disk drive #1 
K: Keyboard 
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1/0 Example 


The example provided in this section illustrates a simple example of 


an I/0 operation using the CIO routine. 


drive 


te me we A 


me me we me we 


1. 


This code segment illustrates the simple example of reading 
text lines (records) from a diskette file named TESTER on disk 


#1. All symbols used are equated within the program 


Opens the file 


i I/0 EQUATES 


although many of the symbols are in the 0S equate file. 
The program performs the following steps: 
‘D1: TESTER’ using IOCB #3. 


2. Reads records until an error or EOF is reached. 
3. Closes the file. 


EOL= $9B i END OF LINE CHARACTER. 
IOCB3= $30 i IOCB #3 OFFSET (FROM IOCB #0). 
ICHID= $0340 i CHANDLER ID -- SET BY CIO}. 
ICDNO= ICHID+1 i (DEVICE # -- SET BY CIO>. 
ICCOM= ICDNO+i i COMMAND BYTE. 

ICSTA= ICCOM+i i STATUS BYTE -- SET BY CIO. 
ICBAL= ICSTA+1 i BUFFER ADDRESS (LOW?. 
ICBAH= ICBAL+1 i BUFFER ADDRESS (HIGH). 
ICPTL= ICBAH+i 

ICPTH= ICPTL+i 

ICBLL= ICPTH+1 i BUFFER LENGTH (LOW>. 
ICBLH= ICBLL+i i BUFFER LENGTH (CHIGH?. 
ICAX1= ICBLH+1 i AUX 1. 

ICAX2= ICAX1i+1 i AUX 2. 

OPEN= $03 i OPEN COMMAND. 

GETREC= $05 i GET RECORD COMMAND. 

CLOSE= s$0C ; CLOSE COMMAND. 

OREAD= #04 i OPEN DIRECTION = READ. 
OWRIT= $08 i OPEN DIRECTION = WRITE. 
EOF= $88 +; END OF FILE STATUS VALUE. 
CIOV= $E456 i CIO ENTRY VECTOR ADDRESS. 


i; FIRST INITIALIZE THE IOCB FOR FILE "OPEN". 


LDX #IOCBS i SETUP TO ACCESS IOCB #3. 


OPERATING SYSTEM CO16555 -- Section S$ 


47 


LDA 
STA 


LDA 
STA 
LDA 
STA 


LDA 
STA 


LDA 
STA 


JSR 
BPL 


JMP 


#0PEN 
ICCOM, X 


#NAME 
ICBAL., X 
#NAME /256 
ICBAH, X 


#0OREAD 
ICAX1, X 


#0 
ICAXa2, X 


"OPEN" THE FILE. 


CIOvV 
TP1d 


ERROR 


i SETUP TO READ A RECORD. 


TP10 LDA 
STA 


LDA 
STA 
LDA 
STA 


i READ RECORDS. 


LOOP LDA 
STA 
LDA 
STA 


JSR 
BMI 


i 


i; A RECORD IS NOW IN THE DATA BUFFER "BUFF". 
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#GETREC 
ICCOM, X 


#BUFF 
ICBAL., X 
#BUFF /256 
ICBAH. X 


#BUFFSZ 
ICBLL., X 


#BUFFSZ/256 


ICBLH, X 


cIOv 
TP20 


i 


SETUP OPEN COMMAND. 

SETUP BUFFER POINTER TO .. 
POINT TO FILENAME. 

SETUP FOR OPEN READ. 


CLEAR AUX 2. 


PERFORM “OPEN OPERATION. 
STATUS WAS POSITIVE -- OK. 


NO -- "OPEN" PROBLEM. 


SETUP “GET RECORD" COMMAND. 


SETUP DATA BUFFER POINTER. 


SETUP MAX RECORD SIZE ... 
PRIOR TO EVERY READ. 


READ A RECORD. 
MAY BE END OF FILE. 
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i AN EOL CHARACTER, AND THE RECORD LENGTH IS IN “ICBLL" and “ICBLH". 
i THIS EXAMPLE WILL DO NOTHING WITH THE RECORD JUST READ. 


JMP LOOP i READ NEXT RECORD. 


i NEGATIVE STATUS ON READ ~~ CHECK FOR END OF FILE. 


TP20 CPY #E0OF i END OF FILE STATUS? 
BNE ERROR i NO -- ERROR. 
LDA #CLOSE i YES -- CLOSE FILE. 
STA ICCOM, X 
JSR cIOVv i CLOSE THE FILE. 
JMP # i ##% END OF PROGRAM #++# 


i DATA REGION OF EXAMPLE PROGRAM 


i 


NAME .BYTE “Di: TESTER", EOL 
BUFFSZ= 80 ; 80 CHARACTER RECORD MAX 
(INCLUDES EOL). 
BUFF=  * ; READ BUFFER. 
t= #+BUFFSZ 
END 


Figure 5-3 An 1/0 Example 
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Device-Specific Information 


This section provides device-specific information regarding the 
device handlers that interface to CIO. 


Keyboard Handler (CK: } 


The keyboard device is a read only device with a handler that 
supports the following CIO functions: 


OPEN 

CLOSE 

GET CHARACTERS 

GET RECORD 

GET STATUS (null function? 


The Keyboard Handler can produce the following error statuses: 


$80 -- CBREAK] key abort. 
$88 -- end-of-file (produced by pressing [CTRLJ 3). 


The Keyboard Handler is one of the resident handlers. It has a 
set of device vectors starting at location E420. 


The keyboard can produce any of the 256 codes in the ATASCII 
character set (see Appendix F)}. Note that a few of the keyboard 
keys do not generate data at the Keyboard Handler level. These 
keys are described below: 


C/i\] —- The ATARI key toggles a flag that enables/disables the 
inversion of bit 7 of each data character read. The 
Screen Editor editing keys are exempted from such 
inversion, however. 


CAPS - The CCAPS/LOWR] key provides three functions: 


CSHIFTICCAPS/LOWRI] -- Alpha caps Lock. 
CCNTRLICCAPS/LOWRI -- Alpha CCTRLI lock. 
CCAPS/LOWR ] ~~ Alpha unlock. 
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The system powers up and will system reset to the alpha 
caps lock option. 


Some key combinations are ignored by the handler. such as 
CCTRLI 4 through CCTRLI 9. CCTRLI O {CCTRLI 1, ECTRLI 7/7. and 
all key combinations in that the CSHIFT] and CCTRLI] keys are 
depressed simultaneously. 

The CCTRLI 3 key generates an EOL character and returns EOF status. 


The CBREAK] key generates an EOL character and returns BREAK status. 


CIO Function Descriptions 


The device-specific characteristics of the standard CIO functions 
(described earlier in this section)? are detailed below: 


OPEN 


The device name is K, and the handler ignores any device number 
and filename specification, if included. 


There are no device-dependent option bits in AUX1 or AUX2. 


CLOSE 


No special handler actions. 


GET CHARACTERS and GET RECORD 


The handler returns the ATASCII key codes to CIO as they are 
entered, with no facility for editing. 


GET STATUS 


The handler does nothing but set the status to $01. 


Theory of Operation 


Pressing a keyboard key generates an IRQ interrupt and vectors to 
the Keyboard Handler’s interrupt service routine (see Section 6). 
The key code for the key pressed is then read and stored in data 
base variable CH CO2FC}. This occurs whether or not there is an 
active read request to the Keyboard Handler, and effects a one-byte 
FIFO for keyboard entry. See Appendix L (EB) for a discussion of 
the auto repeat feature. 
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The Keyboard Handler monitors the CH variable for not containing 
the value $FF (empty state) whenever there is an active read 
request for the handler. When CH shows nonempty, the handler 
takes the key code from CH and sets CH to $FF again. The key code 
byte obtained from CH is not an ATASCII code and has the 
following form: 


7 0 
sp pm hp me pe ch mm pe pm me oh 
iciSt key code i 
. eed Senta ataeds stnate.dheeis state sents aeaete 


Where: C = i if the CCTRLJ] key is pressed. 
S = 1 if the CSHIFT] key is pressed. 


Th 


remaining six bits are the hardware key code. 


The key code obtained is then converted to ATASCII using the 
first of the following rules that applies: 


Ignore the code if the C and S bits are both set. 
If the C bit is set, process the key as a CCTRLI code. 
If the S bit is set, process the key as a (CSHIFT] code. 


codes, all others as lowercase. 


codes, all others as lowercase. 
Else, process as lowercase character. 


Ss Fey 


Then: If the resultant code is not a Screen Editor control code, 
and if the video inverse flag is set. then set bit 7 of the 
ATASCII code (will cause inverse video when displayed}. 
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If £€CTRLI lock is in effect, process alpha characters as CTRL 


IF €SHIFTI] lock is in effect. process alpha characters as SHIFT 


KEY CODE TO ATASCII CONVERSION TABLE 


Key Key Lwr. CSHIFTI CCTRLI Key Key Lwr. SHIFT CTRL 


Code Cap Case Code Cap Case 

00 L &C 4C Oc 20 ’ 2c 3B 00 
O1 J 6A 4A OA at SPACE 20 20 20 
02 i 3B 3A 7B 22 . 2e 3D 40 
O3 _— -- ae a 23 N 6E 4E OE 
04 _ = “a alae 24 aaa ain < ae 
OS K 6B 4B OB 29 M 4D 4D OD 
06 + 2B oC 1E 26 / 2F SF ae 
07 + 2A SE 1F 27 LEN == a balan 
os 0 OF 4F OF 28 R 72 92 i2 
09 -—— -— -_— ea 29 aa = = a 
OA P 70 30 10 2A E 63 45 05 
OB U 73 35 15 2B Y 79 59 19 
oc RET 9B 9B 9B 2C TAB 7F OF SE 
OD I 49 49 09 2D T 74 94 14 
OE _ 2D oF ic 2E W 77 a7 17 
OF = 3D 7¢C 1D 2F Q 71 o1 1i 
10 Vv 76 26 164 30 > 39 28 aos 
il —— om as -— Si ais 5 = ae 
12 C 63 43 03 32 O 30 29 = 
13 -—— —— —— ae 33 7 37 27 sal 
14 —— a = —— 34 BACKS 7E 9C FE 
15 B 62 42 02 35 8 38 40 ene 
14 X 78 28 18 34 < ac 7D 7D 
17 Zz 7A DA 1A 37 > GE 9D Fr 
18 4 34 24 se 38 F 66 44 06 
19 a _— — —— 39 H 68 48 08 
1A 3 33 23 9B# 3A B 64 44 04 
1B & 34 26 aloe 3B casas saat alae =e 
ic CESC] iB 1B iB 3c CAPS -- Sa cada 
iD 3 35 29 a 3D G &7 47 07 
1E 2 32 ae FD GE 5 73 93 13 
iF 1 Si ai — OF A i 4i O1 


# CCTRL] 3 returns EDF status. 


A complement of this table (ATASCII to keystroke} is given in 
Appendix F. 


Figure 5-4 Keycode to ATASCII Conversion Table 
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Display Handler (S: } 


The display device is a read/write device with a handler 
that supports the following CIO functions: 


OPEN 

CLOSE 

GET CHARACTERS 

GET RECORD 

PUT CHARACTERS 

PUT RECORD ; ; 
GET STATUS (null function) 
DRAW 

FILL 


The Display Handler can produce the following error statuses: 


$84 -- Invalid special command. 

$8D -- Cursor out-of-range. 

$91 -- Screen mode > 11. 

$93 -- Not enough memory for screen mode selected. 


The Display Handler is one of the resident handlers, and 
therefore has a set of device vectors starting at location E410. 


Screen Modes 


You can operate the display screen in any of 20 . 
configurations (modes 1 through 8 with or without split 
screeni plus mode QO, and modes 9 through 11 without split 
screen). Mode O is the text displaying mode. Modes 1 through 
11 are all graphics modes (although modes 2 and 3 do display a 
subset of the ATASCII character set). Modes 9 through ii 
require a GTIA chip to be installed in place of the standard 
CTIA chip. 


TEXT MODE 6 


In text mode O the screen is comprised of 24 lines of 40 
characters per Line. Program alterable left and right margins 
limit the display area. They default to 2 and 39 (of a possible 0 
and 39). 
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A program-controllable cursor shows the destination of the next 
character to be output onto the screen. The cursor is visible as 
the inverse video representation of the current character at the 
destination position. 


The text screen data is internally organized as variable length 
logical lines. The internal representation is 24 lines when the 
screen is cleared. Each EOL marks the end of a logical line as 
text is sent to the screen. If more than 3 physical lines of text 
are sent, a logical line will be formed every 3 physical lines. 
The number of physical lines used to comprise a logical line (1 
to 3) is always the minimum required to hold the data for that 
logical line. 


The text screen “scrolls" upward whenever a text line at the 
bottom row of the screen extends past the right margin, or a text 
line at the bottom row is terminated by an EOL. Scrolling removes 
the entire logical line that starts at the top of the screen, and 
then moves all subsequent Lines upward to fill in the void. The 
cursor also moves upward, if the logical Line deleted exceeds one 
physical line. 


All data going to or coming from the text screen is represented 
in B-bit ATASCII code as shown in Appendix E. 


TEXT MODES 1 AND 2 


In text modes 1 and 2 the screen comprises either 24 lines of 20 
characters (mode 1), or 12 lines of 20 characters (mode 2). The 
left and right margins are of no consequence in these modes and 
there is no visible cursor. There are no logical lines associated 
with the data and in all regards these modes are treated as 
graphics modes by the handler. 


Data going to or coming from the screen is in the form shown 
below: 


0 
+t — 4+ 
Cc DB H 
See sheets ante seeate see 


oa fa 
+ 
+ 


Where: C is the color/character-set select field 
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Cc Color Color Character Character 


Value (default) Register Set Set 

(see CHBAS=#E0 CHBAS=$E2 

Appendix 

H) 

0 green. (PF1) a oS CHEART] CARROW] 
1 gold (PFO) oe CHEART] fCARROW] 
2 gold (PFO) Coe fe CDIAMONDIC TRIANGLE ] 
3 gteen (PF1> G8: CDIAMONDICTRIANGLE J 
4 red (PFS) i ler ie CHEART] CARROW] 
3 blue (PF2) fey 2 CHEARTI C ARROW] 
6 blue (PF2) ¢- . CDIAMONDIE TRIANGLE J 
7 red (PFS) e- CDIAMONDIC TRIANGLE J 


Dis a S~bit truncated ATASCII code that selects the specific 
character within the set selected by the C field. See Appendix E 
for the graphics representations of the characters. 


Data base variable CHBAS (O2F4] allows for the selection of 
either of two data sets. The default value of $EO provides the 
capital letters, numbers and punctuation characters: the 
alternate value of $E&2 provides lowercase letters and the special 
character graphics set. 


Figure 5-5 Text Modes 1 and 2 Data Form 


GRAPHICS MODES (Modes G Through 11) 


The screen has varying physical characteristics for each of the 
graphics modes as shown in Appendix H. Depending upon the mode, a 
i to 16 color selection is available for each pixel and the 
screen size varies from 20 by 12 (lowest resolution) to G20 by 
192 (highest resolution) pixels. 


There is no visible cursor for the graphics mode output. 


Data going to or coming from the graphics screen is represented 
as 1 to S-bit codes as shown in Appendix H and in the GET/PUT 
diagrams following. 


SPLIT-SCREEN CONFIGURATIONS 


In split-screen configurations, the bottom of the screen is 
reserved for four lines of mode O text. The text region is 
controlled by the Screen Editor, and the graphics region is 
controlled by the Display handler. Two cursors are maintained in 


this configuration so that the screen segments can be managed 
independently. 
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To operate in split-screen mode, the Screen Editor must first be 
opened and then the Display Handler must be opened using a 
separate IOCB (with the split-screen option bit set in AUX1>. 


CIO Function Descriptions 
The device-specific characteristics of the standard CIO functions 
(described earlier in this section) are detailed below: 

OPEN 


and the handler ignores any device number ani 
if included. 


The device name is S, 
filename specification, 


The handler supports the following options: 


7 O 
ee de Seek cee See Seats ea tae 
AUXI1 { iCiSiwiRi H 
Seats stamais sects seem steels stots stats atmats 
Where: C = 1 indicates to inhibit screen clear on OPEN. 
S$ = 1 indicates to set up a split-screen configuration (for 
modes 1 through & only}. 
R and W are the direction bits (read and write). 
7 Q 
a ee ee on oe oe oe oe 
AUXK2 H i mode i 
Fees shams Saks cote sie, Steet state stems 2 
Where: mode is the screen mode (0 through i113}. 
Note: If the screen mode selected is 0, then the AUX1 C and 


S options are assumed to be O. 


You share memory utilization with the Display Handler 
information. Sharing is necessary because the Display Handler 
dynamically allocates high address memory for use in generating 
the screen display, and because different amounts of memory are 
needed for the different screen modes. Prior to initiating an 
OPEN command the variable APPMHI COOCE] should contain the 
highest address of RAM you need. The Screen handler 

will open the screen only if no RAM is needed at or below that 
address. 


Upon return from a screen OPEN, the variable MEMTOP CO2E5] will 
contain the address of the last free byte at the end of RAM 
memory prior to the screen-required memory. 
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As a result of every OPEN command. the following screen variables 


are altered: 


The text cursor is enabled (CRSINH = 0). The tabs are set to 
the default settings (2 and 39). The color registers are set 
to the default values (shown in Appendix H?. 


Tabs are set at positions 7,15,23, 31,39, 
47,55, 63, 71,79, 87, 95, 103, 111,119. 


CLOSE 


No special handler actions. 


GET CHARACTERS and GET RECORD 


Returns data in the following screen mode dependent forms, where 
each byte contains the data for one cursor position (pixel); there 
is no facility for having the handler return packed graphics data. 


So ee ee 2 


$+ 


+--+ 


+> 
‘ 
' 

+ 


7 


0 


Se ee ste ete eae ee ae 
ATASCII 
tpt tt 


$-- + 


+O + 


+> 


+ 


Figure 5-6 Graphics Mode 


H Mode © 


+—t—+ 

i Modes 1.2 -~ C = color/data 
+++ set. 

D = truncated ATASCII. 
+—+—+ 
i Bi Modes 3.5,7 -- B = color. 
+—+—+ 
on on 
iDt Modes 4,46,8 -- B = color. 

+—+—+ 
eon oe 
D i Modes 9,10,11 -- BD = data. 
ono 


3-11 GET Data Form 


The cursor moves to the next position as gach data byte is 


returned. For mode O, 


99 


the cursor will stay within the specified 
margins; for all other modes, the cursor ignores the margins. 
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PUT CHARACTERS and PUT RECORD 


The handler accepts display data in the following screen mode 
dependent forms: there is no facility for the handler to receive 
graphics data in packed form. 


7 Oo 

Fonts steam steeds cheeks caonts stents see sete 2 

H ATASCII H Mode 0 

tat hat tt ttt 

+ ht — hp am ett 

; CC D ; Modes i,2 --~ C = color/data 
Pea te eS tt set, 


D= truncated ATASCII. 


+ 
Dit Modes 3.5,7 -- D 
+ 


color. 


+> 
i ? iBDi Modes 4,46,8 -- D color. 
+ 


Modes 9,10,11 -~ D = data. 


+O + 


Figure 5-7 Graphics Mode 3-11 PUT Data Form 


NOTE: For all modes, if the output data byte equals $9B (EOL), that 
byte will be treated as an EOL characteri and if the output 

data byte equals $7D (CLEAR) that byte will be treated as a 
screen-clear character. 


The cursor moves to the next cursor position as each data byte is 
written. For mode 0. the cursor will stay within the specified 
margins: for all other modes, the cursor ignores the margins. 


While outputting, the Display Handler monitors the keyboard to 
detect the pressing of the (CTRLJ 1 key combination. When this 
occurs. the handler loops internally until that key combination 
is pressed again: This effects a stop/start function that 
freezes the screen display. Note that there is no ATASCII code 
associated with either the CCTRL] 1 key combination or the 
start/stop function. The stop/start function can be controlled 
only from the keyboard (or by altering database variable CH as 
discussed in Appendix L, E4). 
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GET STATUS 


No handler action except to set the status to $01. 


DRAW 


This special command draws a simulated “straight” line from the 
current cursor position to the location specified in ROWCRS 
C0054] and COLCRS [£00551]. The color of the line is taken from the 
last character processed by the Display Handler or Screen Editor. 
To force the color, store the desired value in ATACHR CO2FBI]. At 
the completion of the command, the cursor will be at the location 
specified by ROWCRS and COLCRS. 


The value for the command byte for DRAW is $11. 


FICL 


This special command fills an area of the screen defined by two 
lines with a specified color. The command is set up the same as 
in DRAW, but as each point of the line is drawn, the routine 
scans to the right performing the procedure shown below (in 
PASCAL notation): 


WHILE PIXEL CROW, COL] = O BO 
BEGIN 
PIXEL CROW, COL] := FILDAT; 
COL := COL + i 
IF COL > Screen right edge THEN COL := 6 
END; 


An example of a FILL operation is shown below: 


Where: ‘~’ represents the fill operation. 
‘+’ are the line points, with ‘+’ for the andpoints. 


“~~ set cursor and plot point. 

“~~ set cursor and DRAW line. 

set cursor and plot point. 

~~ set fill data value, set cursor, and FILL. 


& WM 
| 
| 
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FILDAT CO2FD] contains the fill data, and ROWCRS and COLCRS 
contain the cursor coordinates of the line endpoint. The value 
in ATACHR CO2FB] will be used to draw the line: ATACHR always 
contains the last data read or written, so if the steps above 
are followed exactly, ATACHR will not have to be modified. 


The value for the command byte for FILL is $12. 


User-Alterable Data Base Variables 

Certain functions of the Display Handler require you to 

examine and/or alter variables in the 05 database. The following 
describes some of the more commonly used handler variables. (see 
Appendix tL. Bi-SS. for additional descriptions}. 


Cursor Position 


Two variables maintain the cursor position for the graphics 


screen or mode O text screen. ROWCRS [0054] maintains the display 


row number: and COLCRS [C0055] maintains the display column 
number. Both numbers range from 0O to the maximum number of 
rous/columns, ~- 1. The cursor can be set outside of the defined 
text margins with no ill effect. You can read and write this 
region. The home position (0,0) for both text and graphics is the 
upper left corner of the screen. 


ROWCRS is a single byte. COLCRS is maintained at @-bytes. with 
the least significant byte being at the lower address. 


When you alter these variables, the screen representation 
of the cursor will not move until the next I/0 operation 
involving the display is performed. 


Inhibit/Enable Visible Cursor Display 


You can inhibit the display of the text cursor on the screen 
by setting the variable CRSINH CO2FO] to any nonzero value. 
Subsequent I/O will not generate a visible cursor. 


You can enable the display of the text cursor by setting 
CRSINH to zero. Subsequent I/0 will then generate a visible 
cursor. 


Text Margins 


The text screen has user-alterable left and right margins. The OS 
sets these margins to 2 and 39. The variable LMARGN [0052] 
defines the left margin, and the variable RMARGN [COO53] defines 
the right margin. The leftmost margin value is O and the 
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rightmost margin value is 39. 


The margin values inclusively define the useable portion of the 
screen for all operations in that you do not explicitly 

alter the cursor location variables as described prior to this 
paragraph. 


Color Control 


The OS updates hardware color registers using data from the OS 
data base as part of normal Stage 2 VBLANK processing (see Section 


&). 
register names, 


Shown below are the data base variable names, 
and the function of each register. 


for the mode dependent uses for the registers. 


the hardware 
See Appendix H 


Data Base Hardware Function 

COLORO COLPFO PFO ~~ Playfield © 

COLOR1 COLPF Ii PFi -- Playfield i. 

COLOR2 COLPF2 PF2 -- Playfield 2. 

COLORS COLPFS3 PF3 ~~ Playfield 3. 

COLOR4 COLBK BAK -~- Playfield background. 
PCOLRO COLPMO PMO -~- Player/missile 0. 
PCOLR1 COLPM1 PM1 -~ Player/missile 1. 
PCOLR2 COLPM2 PM2 -- Player/missile 2. 
PCOLRS COLPM3 PM3 -- Player/missile 3 


Theory of Operation 


The Display Handler automatically sets up all memory resources 
required to create and maintain the screen display at OPEN time. 
The screen generation hardware requires that two distinct data 
areas exist for graphics modes: 


screen data region. 


1} a display list and 2) a 
A third data area must exist for text modes. 


This data area defines the screen representation for each of the 
Consult the ATARI Home Computer 
Hardware Manual for a complete understanding of the material that 


text characters. 


is to follow. 
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The simplified block diagram below shows the relationships 
between the memory and hardware registers used to set up a screen 
display (without player/missile graphics) by the OS Note that 

the hardware registers allow for many other possibilities. 


DATA BASE HARDWARE 
VARIABLE REGISTER 
(Updated every 
VBLANK > 
$e + 
i MEMTOP H 
+ + 
H H 
» eteatents dhaateatemtenteenaee + 
: cantanieaatanteatenteeteatenantentetenten + 
{$e + 
if ‘ 
$—-—— +--+ —-— SR er + pm ee a no en + | 
i Display { {| SDLSTL i i: DLISTL ¢{ i 
i List i + +——-—— >+ oh 
= = { SDLSTH i i DLISTH | 
$e ee + +2 + $—-— - - + 
8 8 
: fe Glee * 
i Screen Data !<--— SAVMSC H 
= = + + 
i Graphics if i 
i and/or bo peer een ne + 
i Text i 
, cententrtenontententententententeeteas + 
End of RAM memory 
om em a a a ca ee a oe + 
H a a a et a ee mee + $e eee ee + H 
H i CHBAS=EO i--->! CHBASE +---~-- + 
H S antestentententententemtmatan + $e e ee e +> 
pe +-—- + 
i Specials andi EOOO 
{ Numbers H 
th + 
i Capital t E100 
i Letters H 
$— + 
i Special i E200 
i Graphics i 
S eeeateetentententeatententeetenteaten + 
i Lowercase i E300 
i Letters ‘ 
th + 
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$e + S Loneatueneteatenentanaet + 
{ COLOR O | | COLPFO | 
= =-->! COLPFi | 
COLOR i | {| COLPF2 | 
: COLOR 2: | COLPFS | 
: COLOR 3: {! COLBK | 
f COLOR 4 f 0 t—-------- + 
a ee + 


Figure 5-8 Screen Display Block Diagram 


The following relationships are present in the preceding diagram: 


1. 
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Data base variables SDLSTL/SDLSTH contain the address of 
the current display list. This address is stored in the 
hardware display list address registers DLISTL and DLISTH 
as part of the VBLANK process. 


The display list itself defines the characteristics of the 
screen to be displayed and points to the memory containing 
the data to be displayed. 


Data base variable CHBAS contains the MSB of the base address 
of the character representations for the character data (text 
modes only?>. 


The default value for this variable is SEO. This variable 
declares that the character representations start at memory 
address EQ00 (the character set provided by the 0S in ROM}. 
Each character is defined as an 8X8 bit matrix, requiring & 
bytes per character. 1024 bytes are required to define the 
largest set, since a character code contains up to 7 
significant bits (set of 128 characters}. The OS ROM contains 
the default set in the region from EQCO to ESFF. 


All character codes are converted by the handler from ATASCIIT 
to an internal code (and vice versa), as shown below: 


ATASCII INTERNAL 
CODE CODE 
00-1F 40-SF 
20-3F OO-1F 
40-5F 20-3F 
60-7F 60-7F 
80-9F CO-DF 
AO-BF 80-9F 
CO-DF AO-BF 
EO-FF EO-FF 
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The character set in ROM is ordered by internal code order. Three 
considerations differentiate the internal code from the external 
(ATASCII} code: 


ATASCII codes for all but the special graphics characters were to 
be similar to ASCII. The alphabetic, numeric, and punctuation 
character codes are identical to ASCII. 


In text modes 1 and 2 it was desired that one character subset 
include capital letters, numbers, and punctuation and the ather 
character subset include lowercase letters and special graphics 
characters. 


The codes for the capital and lowercase letters were to be 
identical in text modes 1 and 2. 


Database variables COLORO through COLOR4 contain the current 
color register assignments. Hardware color registers receive 
these values as part of the stage i VBLANK process, thus 
providing synchronized color changes (see Appendix H). 


Database variable SAVMSC points to the lowest memory address of 
the screen data region. It corresponds to the data displayed at 
the upper left corner of the display. 


When the Display Handler receives an open command, it first 
determines the screen mode from the OPEN IOCB. Then it allocates 
memory from the end of RAM downward (as specified by data base 
Variable RAMTOP>), first for the screen data and then for the 
display list. The screen data region is cleared and the display 
list is created if sufficient memory is available. The display 
list address is stored to the database. 
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Screen Editor (E: } 


The Screen Editor is a read/write handler that uses the Keyboard 
Handler and the Display Handler to provide “line-at-a-time" input 
with interactive editing functions, as well as formatted output. 


The Screen Editor supports the following CIO functions: 


OPEN 

CLOSE 

GET CHARACTERS 

GET RECORD 

PUT CHARACTERS 

PUT RECORD 

GET STATUS (null function) 


See Keyboard Handler and Display Handler Sections for a 
discussion of Screen Editor error statuses. 


The Screen Editor is one of the resident handlers, and 
therefore has a set of device vectors starting at location 
E400. 


The Screen Editor is a program that reads key data from the 
Keyboard Handler and sends each character to the Bisplay Handler 
for immediate display. The Screen Editor also accepts data from 
you to send to the Display Handler, and reads data from the 
Display Handler (not the Keyboard Handler) for you. In fact, 

the Keyboard Handler, Display Handler, and the Screen Editor are 
all contained in one monolithic hunk of code. 


Most of the behaviors already defined for the Keyboard Handler 
and the Display Handler apply as well to the Screen Editor: The 
discussions in this Section will be limited to deviations from 
those behaviors, or to additional features that are part of the 
Screen Editor only. The Screen Editor deals only with text data 
(screen mode ©O). This Section also explains the split-screen 
configuration feature. 


The Screen Editor uses the Display Handler to read data from 
graphics and text screens on demand. You use the Screen 

Editor to determine when the program will read Screen data, and 
where upon the screen the data will be read from. You 

first locates the cursor on the screen to determine the screen 
area to be readi you then press the CRETURN] key to determine 
when the program will begin to read the data indicated. 
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When the CRETURN] key is pressed, the entire logical line within 
that the cursor resides is then made available to the calling 
program: Trailing blanks in a logical line are never returned as 
data, however. After all of the data in the line has been sent to 
the caller (this can entail multiple READ CHARACTERS functions if 
desired), an EOL character is returned and the cursor is 
positioned to the beginning of the Logical line following the one 
just read. 


CIO Function Descriptions 


The device-specific characteristics of the standard CIO 
functions are detailed below: 


OPEN 


The device name is E, and the Screen Editor ignores any 
device number and filename specification, if included. 


The Screen Editor supports the following option: 


7 0 

eee shoets stata aeects shame stent sete sea 

AUXi H iWiRi tFi 
ami sheets mts coats stenie shoei seam 


Where: R and W are the direction bits (read and write)?. 
F = 1 indicates that a “forced read“ is desired (see GET 
CHARACTER and GET RECORD for more information). 


CLOSE 


No special handler actions. 


GET CHARACTER and GET RECORD 


Normally the Screen Editor will return data only when you press the 
CRETURN] key at the keyboard. However, the “forced read" OPEN option 
allows you to read text data without intervention. When you command a 
READ operation, the Screen Editor will return data from the start of 
the logical line in which the text cursor is located, and then 

move the cursor to the beginning of the following logical line. A 
read of the last logical line on the screen will cause the screen 
data to scroll. 


A special case occurs when characters are output without a 
terminating EOL, and then additional characters are appended to 
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that logical line from the keyboard. When the CRETURN] key is 
pressed, only the keyboard entered characters are sent to the 
caller, unless the cursor has been moved out of and then back 
into the logical line. in that case all of the logical line will 
be sent. | 


PUT CHARACTER and PUT RECORD 


The Handler accepts ATASCII characters as one character per byte. 
Sixteen of the 256 ATASCII characters are control codesi the EOL 
code has universal meaning, but most of the other control codes 
have special meaning only to a display or print device. The 
Screen Editor processing of the ATASCII control codes is 
explained below: 


CLEAR ($7D} -- The Screen Editor clears the current display of 
all data and the cursor is placed at the home position (upper 
left corner of the screen}. 


CURSOR UP ($1C) -- The cursor moves up by one physical line. The 
cursor will wrap from the top line of the display to the bottom 
line. 


CURSOR DOWN (#1D) -- The cursor moves down by one physical line. 
The cursor will wrap from the bottom line of the display to the 
top line. 


CURSOR LEFT ($1E} -- The cursor moves left by one column. The 
cursor will wrap from the left margin of a line to the right 
margin of the same line. 


CURSOR RIGHT ($1F) -- The cursor moves right by one column. The 
cursor will wrap from the right margin of a line to the left 
margin of the same line. 


BACKSPACE ($7E} -- The cursor moves left by one column (but never 
past the beginning of a logical line), and the character at that 
new position is changed to a blank (#20). 
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SET TAB ($9F)} -- The Screen Editor establishes a tab point at the 
logical line position at that the cursor is residing. The logical 
line tab position is not synonymous with the physical line column 
position since the logical line can be up to 3 physical lines in 
length. For example, tabs can be set at the 15th, 30th, 45th, 
460th and 75th character positions of a logical line as shown 
below: 


O02 9 i9 29 39 Screen column #. 
ge ae Ne ee een aca PAS ane eat R L/R = margins. 
Lia eae S Seas [SSeS Serer scarica iene A logical line. 
LS Ssaee [SeSesses eS Sala ae aad a rea t= x = inaccessible 
KL Se Se Sr SS Sk SSeS SS Se ee SSeS ee Sa columns. 


Note the effect of the left margin in defining the limits of the 
logical Line. 


The Handler default tab settings are shown below: 


02 9 19 29 39 Screen column #. 
a aha a PS ee ete fama Passa es R L/R = margins. 
Ki tease TSH eeSs= [eae eemer {arse ese Sse T A logical line. 
Search Leos lerSsess bone Teena T x = inaccesible 
ies 6 aa THSSSHas De eamca aaa Leer er es T columns. 
CLEAR TAB ($9E)} ~-- The Screen Editor clears the current cursor 


position within the logical line from being a tab point. There is 
no “clear all tab points" facility provided by the Handler. 


TAB ($7F) -- The cursor moves to the next tab point in the 
current Logical line, or to the beginning of the next line if no 
tab point is found. This function will not increase the logical 
line Length to accommodate a tab point outside the current length 
(e.g. the logical line length is 38 characters and there is a tab 
point at position 5Q}. 


INSERT LINE ($9D)} -- All physical lines at and below the physical 
line in that the cursor resides, are moved down by one physical 
line. The last logical line on the display can be truncated as a 
result. The blank physical line at the insert point becomes the 
beginning of a new logical line. A logical line can be split into 
two logical lines by this process, the last half of the original 
logical line being concatenated with the blank physical line 
formed at the insert point. 
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DELETE LINE ($9C} -- The logical line in that the cursor resides 
is deleted and all data below that line is moved upward to fill 
the void. Empty logical lines are created at the bottom of the 
display. 


INSERT CHARACTER ($FF) -- All physical characters at and behind 
the cursor position on a logical line are moved one position to 
the right. The character at the cursor position is set to blank. 
The last character of the logical line will be lost when the 
logical line is full and a character is inserted. The number of 
physical lines comprising a logical line can increase as a result 
of this function. 


DELETE CHARACTER ($FE)} -- The character on which the cursor 
resides is removed, and the remainder of the logical line to the 
right of the deleted character is moved to the left by one 
position. The number of physical lines composing a logical line 
can decrease as a result of this function. 


ESCAPE ($158) -- The next non-EOL character following this code is 
displayed as data, even if it would normally be treated as a 
control code. The sequence CESCICESC] will cause fhe second CESC] 
character to be displayed. 


BELL ($FD) -- An audible tone is generated: the display is not 
modified. 
END OF LINE ($9B) -- In addition to its record termination 


function, the EOL causes the cursor to advance to the beginning 
of the next logical line. When the cursor reaches the bottom line 
of the screen, the receipt of an EOL will cause the screen data 
to scroll upward by one logical line. 


GET STATUS 


The Handler takes no action other than to set the status to $01. 


User-Alterable Data Base Variables 


Also see the Display Handler data base variable discussion. 
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Cursor Position 


When in a split-screen configuration, ROWCRS and COLCRS are associated 
with the graphics portion of the display and two other variables, 
TXTROW €O290] and TXTCOL CO291], are associated with the text window. 
TXTROW is a single byte, and TXTCOL is @-bytes with the least 
Significant byte being at the lower address. Note that the most 
significant byte of TXTCOL should always be zero. 


The home position (0,0) for the text window is the upper left corner 
of the window. 


Enable/Inhibit of Control Codes in Text 


Normally all text mode control codes are operated upon as received, 
but sometimes it is desirable to have the control codes displayed as 
if they were data characters. This is done by setting the variable 
DSPFLG CO2FE] to any nonzero value before outputting the data 
containing control codes. Setting DSPFLG to zero restores normal 
processing of text control codes. 
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Cassette 


Handler (C: } 


The Cassette device is a read or write device with a Handler 
that supports the following CIO functions: 


OPEN 
CLOSE 


GET CHARACTERS 

GET RECORD 

PUT CHARACTERS 

PUT RECORD 

GET STATUS (null function? 


The Cassette Handler can produce the following error statuses: 


$80 -- 
$84 -- 
$88 -- 
$BA-90 


CBREAK] key abort. 

Invalid AUX1 byte on OPEN. 
end-of-file. 

-~- SIO error set (see Appendix C}. 


The Cassette Handler is one of the resident handlers, and therefore 
has a set of device vectors starting at location E440. 


CIO Function Descriptions 


The device- 


specific characteristics of the standard CIO functions are 


detailed below: 


OPEN 


The device 


name is C, and the Handler ignores any device number and 


filename specification, if included. 


The Handler supports the following option: 
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7 6) 
ttt 4-4 tt 

AUX2 ici i 
+t tt 


Where: C = 1 indicates that the cassette is to be read/written without 
stop/start between records (continuous mode). 


Opening the cassette for input generates a single audible tone, as a 
prompt for you to verify that the cassette player is set up 

for reading (power on; Serial Bus cable connectedi tape cued to start 
of file; and PLAY button depressed). When the cassette is ready, 

you can press any keyboard key (Cexcept CBREAK]} to initiate tape 
reading. 


Opening the cassette for output generates two closely spaced audible 
tones, as a prompt for you to verify that the cassette player 

is set up for writing (as above, plus RECORD button depressed). When 
the cassette is ready, you can press any keyboard key (except 

CBREAKI? to begin tape writing. There is no way for the computer to 
verify that the RECORD or PLAY button is depressed. It is possible for 
the file not to be written. with no immediate indication of this fact. 


There is a potential problem with the cassette in that when the 
cassette is opened for writing, the motor keeps running until the 
first record (128 data bytes) is written. If 128 data bytes are 
written or the cassette is closed within about GO seconds of the OPEN, 
and no other serial bus I1/0 is performed, then there is no problem. 
However, if those conditions are not met. some noise will be written 
to the tape prior to the first record and an error will occur when 
that tape file is read later. If lengthy delays are anticipated 
between the time the cassette file is opened and the time that the 
first cassette record (128 data bytes) is written, then a dummy record 
should be written as part of the file; typically 128 bytes of some 
innocwuous data would be written, such as all zeros, all $FFs, or all 
blanks ($20). 


The system sometimes emits whistling noises after cassette 1/0 has 
occurred. The sound can be eliminated by storing $03 to SKCTL CD2OF], 
thus bring POKEY out of the two-tone (FSK) mode. 
CLOSE 
The CLOSE of a tape read stops the cassette motor. 
The CLOSE of a tape write does the following: 
Writes any remaining user data in the buffer to tape. 


Writes an end-of-file record. 
Stops the cassette motor. 
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GET CHARACTERS and GET RECORD 
The Handler returns data in the following format: 


7 0 
t—t—+— 4-4 tt 
i data byte H 
Seeds seats cee ee ee sets ee ate 


PUT CHARACTERS and PUT RECORD 
The Handler accepts data in the following format: 


7 0 
$a tt $$ tt 
H data byte i 
peta ptt — 4 + 


The Handler attaches no significance to the data bytes 
written, a value of $9B (E0L) causes no special action. 


GET STATUS 


‘The Handler does no more than set the status to $01. 


Theory of Operation 


The Cassette Handler writes and reads all data in fixed-length records 
of the format shown below: 


+b tt — 4 tt 
iO 1010101: Speed measurement bytes. 
$e pF 
‘0101010 1% 
$4 
control byte 
bp tt 
128 

data 

bytes 
pmb tt 
‘ checksum 
ei shan Soni shants stem she ateate. cet 


-$-- i -- + 


(Managed by SIO, not the 
Handler. } 


oe oe oe Ses 


Figure 5-9 Cassette Handler Record Format 
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The control byte contains one of three values: 
o «$FC indicates the record is a full data record (128 bytes>. 


o $FA indicates the record is a partially full data record; you 
supplied fewer than 128 bytes to the record. This case can 
occur only in the record prior to the end-of-file. The number 
of user-supplied data bytes in the record is contained in the 
byte prior to the checksum. 


o $FE indicates the record is an End-of file record: the data 
portion is all zeroes for an end-of-file record. 


The SIO routine generates and checks the checksum. It is part of the 
tape record, but it is not contained in the Handler’s record buffer 
CASBUF COSFD1. 

The processing of the speed-measurement bytes during cassette reading 
is discussed in Appendix L, D1i-D7. 

File Structure 

The Cassette Handler writes a file to the cassette device with a file 
structure that is totally imposed by the Handler (soft format). A file 
consists of the following three elements: 

o A 20-second leader of mark tone. 


o Any number of data-record frames. 


o An end-of-—file frame. 


The cassette-data record frames are formatted as shown below: 


frame = pre-record write fone (PRWT?, 
+ data record, 
+ post record gap (PRG} 


The nondata portions of a frame have characteristics that are 
dependent upon the write OPEN mode, i.e. continuous or 
start/stop. 


Stop/start PRWT = 3 seconds of mark tone. 
Continuous PRWT = .25 second of mark tone. 


Stop/start PRG 
Continuous PRG 


up to 1 second of unknown tones. 
from 0 to n seconds of unknown tones, where 
nis dependent upon your program timing. 


The inter-record gap (IRG) between any two records consists of 
the PRG of the first record followed by the PRWT of the second 
record. 
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Printer Handler (P: } 


The Printer device is a write-only device with a Handler that 
supports the following CIO functions: 


OPEN 
CLOSE 
PUT CHARACTERS 


PUT RECORD 
GET STATUS 


The Printer Handler can produce the following error statuses: 
$8A-90 -- SIO error set (see Appendix C?}. 


The Printer Handler is one of the resident handlers. and 
therefore has a set of device vectors starting at location E430. 


CIO Function Descriptions 


The device-specific characteristics of the standard CIO functions 
are detailed below: 


OPEN 


The device name is P. The Handler ignores any device number and 
filename specification, if included. 


CLOSE 


The Handler writes any data remaining in its buffer to the 
printer device. with trailing blanks to fill out the Line. 


PUT CHARACTERS and PUT RECORD 


The Handler accepts print data in the following format: 


7 OG 
S ceeaahents steeta.steets seeaie ateets stents 
H ATASCITI 
see sbente seated Sie coon cee. ane 


$$ -- + 


The only ATASCII control code of any significance to the Handler 
is the EOL character. The printer device ignores bit 7 of every 

data byte and prints a sub set of the remaining 128 codes. (see 

Appendix G for the printer character set). 


The Handler supports the following print option: 
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FF 0 
Scam shee. teams coats ten toes ste atone 
AUX2 i print mode i 
Sea Semi eis stents stents ste Sent See 


Where: $4E (N) selects normal printing (40 characters per line). 
$53 (S) selects sideways printing (29 characters per line). 
$57 (W) selects wide printing (not supported by printer 

device). 


Any other value (including 00) is treated as a normal (N) 
print select, without producing an error status. 
GET STATUS 
The Handler obtains a 4-byte status from the printer 


controller and puts it in system location DVSTAT CO2ZEA]. The 
format of the status bytes is shown below: 


+ 


Dem sheet seats eis cee cies state ted 
i command stat. 
See ete ete eee eee ee See 
i AUX2 of prev. 
$b 4 
H timeout 
pp pe 
H Cunused } 
Ce ee ee oe or 


DVSTAT + 6 


ee a 
+ 
iY) 


The command status contains the following status bits and 
condition indications: 


bit 0: an invalid command frame was received. 
bit 1: an invalid data frame was received. 
bit 7: an intelligent controller (normally = 0}. 


The next byte contains the AUX2 value from the previous operation. 


The timeout byte contains a controller provided maximum timeout 
value (in seconds}. 


Theory of Operation 


The ATARI S2O0CTM] 40-Column Printer is a line-at-a-time printer rather 
than a character-at-a-time printer, so your data must be buffered by 
the Handler and sent to the device in records corresponding to one 
print line (40 characters for normal, 29 characters for sideways). 
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The printer device does not attach any significance to the EOL 
character, so the Handler does the appropriate blank fill 
whenever if sees an EOL. 


Disk File Manager (D: } 


The OS supports four unique File Management Subsystems at the 
time of this writing. Version IA is the original version. 

Version IB is a slightly modified version of IA and is the one 
described in this document. Most of this discussion applies as 
well to Version II. that handles a double-density diskette (720 
256-byte sectors}? in addition to the single~densifty diskette (720 
128-byte sectors}. Version III has all new file/directory/map 
structures and can possibly contain changes to your interface 

as well. 


The File Management Subsystem includes a disk-bootable 
(RAM-resident} Disk File Manager (DFM) that maintains a 
collection of named files on diskettes. Up to 4 disk drives 

(D1: through BD4:} can be accessed, and up to 64 files per 
diskette can be accessed. The system diskettes supplied by ATARI 
allow a single disk drive (D1) and up to 3 OPEN files, but 

you can alter these numbers as described later in 

this section. 


The Disk File Manager supports the following CIO functions: 


OPEN FILE 

OPEN DIRECTORY 
CLOSE 

GET CHARACTERS 
GET RECORD 

PUT CHARACTERS 
PUT RECORD 

GET STATUS 


NOTE 
POINT 
LOCK 
UNLOCK 
DELETE 
RENAME 
FORMAT 
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The Disk File Manager can produce the following error statuses: 


$03 -- Last data from file (EOF on next read). 

$88 -- end-of-file. 

$8A4-90 -- SIO error set (see Appendix C}. 

$AC -- Drive number specification error. 

$Ai -- No sector buffer available (too many open files). 
$A2 -- Disk full. 

$43 -- Fatal I/0 error in directory or bitmap. 

$44 -- Internal file # mismatch (structural problem). 
$A5 -- File name specification error. 

$A& -- Point information in error. 

$A7 -- File locked to this operation. 

SAS -- Special command invalid. 

$A9 -- Directory full (64 files?). 

SAA -- File not found. 

$A4B -- Point invalid (file not OPENed for update). 


CIO Function Descriptions 


The device-specific characteristics of the standard CIO functions 
ate detailed below: 


OPEN FILE 


The device name is D. Up to four disk drives can be accessed (Di 
through D4). The disk filename can be from 1 to & characters in 
length with an optional 1i- to G-character extension. 


The OPEN FILE command supports the following options: 


+ 
AUXI i 
+ 


Where: W and R are the direction bits. 
WR = OO is invalid 
Ol indicates OPEN for read only. 
10 indicates OPEN for write only. 
11 indicates OPEN for read/write (update?). 


& = 1 indicates appended output when W = 1. 


You may use these following valid AUX1 options: 
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OPEN Input (AUX1 = $04) 


The indicated file is opened for input. Any wild-card characters 
are used to search for the first match. If the file is not found, 
an error status is returned, and no file will be opened. 


OPEN Output (CAUXI = $08) 


The indicated file is opened for output starting with the first 
byte of the file, if the file is not locked. Any wild-card 
characters are used to search for the first match. If the file 
already exists, the existing file will be deleted before opening 
the named file as a new file. If the file does not already exist, 
it will be created. 


A file opened for output will not appear in the directory until 
it has been closed. If an output file is not properly closed, 
some or all of the sectors that were acquired for it can be lost 
until the disk is reformatted. 


A file that is opened for output can not be opened concurrently 
for any other access. 


OPEN Append (AUX1 = $09) 


The indicated file is opened for output starting with the byte 
after the last byte of the existing file (that must already 
exist), if the file is not locked. Any wild-card characters are 
used to search for the first match. 


If a file opened for append is not properly closed, the appended 
data will be lost. The existing file will remain unmodified and 
some or all of the sectors that were acquired for the appended 
portion can be lost until the diskette is reformatted. 


OPEN Update (AUX1 = $0C} 


The indicated file (that must already exist} will be opened for 
update provided it is not locked. Any wild-card characters are 
used to search for the first match. 


The GET, PUT, NOTE and POINT operations are all valid, and can be 
intermixed as desired. 


If a file opened for update is not properly closed, a sector's 
worth of information can be lost to the file. A file opened for 
update can not be extended. 
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Device/Filename Specification 


The Handler expects to find a device/filename specification of 
the following form: 


DC<number>]: <filename><EOL> 
where: 


<number> ::= L12iai4a 

<filename> = (€<primaryo ll. C<extension>J]<terminator> 

<primary> ::= an uppercase alpha character followed by O to 7 
alphanumeric characters. If the primary name is 
less than & characters, it will be padded with 
blanks; if it is greater than & characters, the 
extra characters will be ignored. 


Cextension> ::= Zero to 3 alphanumeric characters. If the 
extension name is missing or less than 3 
characters, it will be padded with blanks; if 
it is greater than 3 characters, the extra 
characters will be ignored. 


<terminator> ::= <EOL>i<blank> 


Figure 5-10 Device/Filename Syntax 


The following are all valid device/filenames for the diskette: 


Di: GAME. SRC 
D: MANUAL6 
D: . WHY 

D3: FILE. 

D4: BRIDGE. 002 


Filename Wildcarding 


The filename specification can be further generalized to include 
the use of fhe “wild-card” characters * and ?. These wildcard 
characters allow portions of the primary and/or extension to be 
abbreviated as follows: 


The ? character in the specification allows any filename 
character at that position to produce a “match. “ For example, WH? 
will match files named WHO, WHY. WH4, etc.;, but not a file named 
WHAT. 
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The #* character causes the remainder of the primary or extension 
field in that it is used to be effectively padded with 7? 
characters. For example, WH* will match WHO, WHEN, WHATEVER, etc. 


Some valid uses of wild-card specifications are shown below: 


#. SRC Files having an extension of SRC. 

BASIC. # Files named BASIC with any extension. 

%. % All files. 

Ht. ? | Files beginning with H and having a O or i 


character extension. 


If wildcarding is used with an OPEN FILE command. the first file 
found (if any) that meets the specification will be the one (and 
only one) opened. 


OPEN DIRECTORY 


The OPEN DIRECTORY command allows you read directory 

information for the selected filename(s}, using normal GET 
CHARACTERS or GET RECORD commands. The information read will be 
formatted as ATASCII records, suitable for printing, as shown 
below. Wildcarding can be used to obtain information for multiple 
files or the entire diskette. 


The OPEN DIRECTORY command uses the same CIO parameters as a standard 
OPEN FILE command: . 


COMMAND BYTE = $03 
BUFFER ADDRESS = pointer to device/filename specification. 
AUX1 = $06 
After the directory is opened, a record will be returned to the 
caller for each file that matches the OPEN specification. The 


record, that contains only ATASCII characters, is formatted as 
shown belougs: 


1 
1234567897 012345678 
pha ha a att atta tte tet tn tae tant 
istbi primary name {| ext ibticountiei 
ptt ha ta th bat at ae ett tt ttt 
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Where: s = #* or ‘ % with # indicating file locked. 
b = blank. 
primary name = left-yustified name with blank fill. 
ext = left-justified extension with blank fill. 
b = blank. 
count = number of sectors comprising the file. 
e = EOL ($9B). 


After the last filename match record is returned, an additional 
record is returned. This record indicates the number of unused 


sectors available on the diskette. The format for this record is shown 
below: 


1 
123945464789 012345 47 
tha ha hh ha att ae ae tan tat tat ttt 
tcounti FREE SECTOR Siei 
aha ha a a at a ta tan ta tt te ttn 


Where: count = the number of unused sectors on the diskette. 
e = EOL ($9B). 


The EOF statuses ($03 and $88) are returned as in a normal data 
file when the last directory record is read. 


The opening of another diskette file while the directory read is 
open will cause subsequent directory reads to malfunction, so 
care must be taken to avoid this situation. 


CLOSE 


Upon closing a file read, the Handler releases all internal 
Tesources being used to support that file. 


Upon closing a file write, the Handler: 


o writes any residual data from its file buffer for that file 
to the diskette. 


ra) updates the directory and allocation map for the associated 
diskette. 


o releases all internal resources being utilized to support 
that file 


GET CHARACTERS and GET RECORD 


Characters are read from the diskette and passed to CIO as a raw 
data stream. None of the ATASCII control characters have any 
special significance. A status of $88 is returned if an attempt 
is made to read past the last byte of a file. 
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PUT CHARACTERS and PUT RECORD 


Characters are obtained from CIO and written to the diskette as a raw 
data stream. None of the ATASCII control characters have any special 
significance. 


GET STATUS 


The indicated file is checked and one of the following status 
byte values is returned in ICSTA and register Y: 


$01 -- File found and unlocked. 
$A7 -- File locked. 
$AA -- File not found. 


Special CIO Functions 


The DFM supports a number of SPECIAL commands. that are device 
specific. These are explained in the paragraphs that follow: 


NOTE (COMMAND BYTE = $25} 


This command returns to the caller the exact diskette Location of 


the next byte to be read or written, in the variables shown 
below: 


ICAX3 = LSB of the diskette sector number. 
ICAX4 = MSB of the diskette sector number. 
ICAX5 = 


relative sector displacement to byte (0-124}. 


POINT (COMMAND BYTE = $26) 


This command allows you to specify the exact diskette location of 
the next byte to be read or written. In order to use this commmand, 
the file must have been opened with the “update" option. 


ICAX3S = LSB of the diskette sector number. 
ICAX4 = MSB of the diskette sector number. 
ICAXS5 = 


relative sector displacement to byte (0-124). 
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LOCK 


This command allows you to prevent write access to any 

number of named files. Locked files can not be deleted, renamed, 
nor opened for output unless they are first unlocked. Locking a 
file that is already locked is a valid operation. The Handler 
expects a device/filename specificationi then all occurrences of 
the filename specified will be locked, using the wild-card rules. 


You set up these following IOCB parameters prior to 
calling CIO: 


COMMAND BYTE = $23 
BUFFER ADDRESS = pointer to device/filename specification. 


After a LOCK operation, the following IOCB parameter will have 
been altered: 


STATUS = result of LOCK operation; see Appendix B for a list 
of possible status codes. 


UNLOCK 


This command allows you to remove the lock status of any 

number of named files. Unlocking a file that is not locked is a 
valid operation. The Handler expects a device/filename 
specification; then all occurrences of the filename specified 
will be unlocked, using the wild-card rules. 


You set up these following IOCB parameters prior to 
calling CIO: 


COMMAND BYTE = $24 
BUFFER ADDRESS = pointer to device/filename specification. 


After an UNLOCK operation, the following I0OCB parameter will have been 
altered: 


STATUS = result of UNLOCK operationi see Appendix B for a 
list of possible status codes. 


DELETE 


This command allows you to delete any number of unlocked 

named files from the directory of the selected diskette and to 
deallocate the diskette space used by the files involved. The 
Handler expects a device/filename specification: then all 
occurences of the filename specified will be deleted. using the 
wild-card rules. 
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You set up these following IOCB parameters prior to 
calling CIO: 


COMMAND BYTE = $21 
BUFFER ADDRESS = pointer to device/filename specification. 


After a DELETE operation, the following IOCB parameter will have 
been altered: 


STATUS = result of DELETE operationi see Appendix B for a list of 
possible status codes. 


RENAME 


This command allows you to change the filenames of any 
number of unlocked files on a single diskette. The Handler 
expects to find a device/filename specification that follows: 


<device spec>:<filename spec>,<filename spec><EOL> 


All occurrences of the first filename will be replaced with the 
second filename, using the wild-card rules. No protection is 
provided against forming duplicate names. Once formed, duplicate 
names cannot be separately renamed or deleted: however, an OPEN 
FILE command will always select the first file found that matches 
the filename specification, so that file will always be 
accessible. The RENAME command does not alter the content of the 
files involved, merely the name in the directory. 


Examples of some valid RENAME name specifications are shown 
below: 


Di: #. SRC, #. TXT 
DB: TEMP, FDATA 
D2: F#, F#. OLD 


You set up these following IOCB parameters prior fo 
calling CIO: 


COMMAND BYTE = $20 
BUFFER ADDRESS = pointer to device/filename specification. 


After a RENAME operation, the following IOCB parameter will have 
been alterad: . 


STATUS = result of RENAME operation: see Appendix B for a 
list of possible status codes. 
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FORMAT 


Soft-sector diskettes must be formatted before they can store 
data. The FORMAT command allows you to physically format a 
diskette. The physical formatting process writes a new copy of 
every sector on the soft-sectored diskette, with the data portion 
of each sector containing all zeros. The FORMAT process creates 
an “empty" non system diskette. When the formatting process is 
complete, the FMS creates an initial Volume Table of Contents 
(VTOC} and an initial File Directory. The boot sector (#1) is 
permanently reserved as part of this process. 


You set up these following IOCB parameters prior to 
calling CIO: 


COMMAND BYTE = $FE 
BUFFER ADDRESS = pointer to device specification. 


After a FORMAT operation, the following IOCB parameter will have 
been altered: 


STATUS = result of FORMAT operation: see Appendix B for a 
list of possible status codes. 


To create a system diskette, a copy of the boot file must then be 
written to sectors #2-n. This is accomplished by writing the file 
named DOS.SYS. This is a name that is recognized by the FMS even 
though it is not in the directory initially. 


Theory of Operation 


The resident OS initiates the disk-boot process (see Section 10). 
The OS reads diskette sector #1 to memory and then transfers 
control to the “boot continuation address“ (boot address + 6}. 
The boot-continuation program contained in sector #1 then 
continues to load the remainder of the File Management Subsystem 
to memory using additional information contained in sector #1. 
The File Management Subsystem loaded, will contain a Disk File 
Manager ,and optionally, a Disk Utilities (BOS) package. 


When the boot process is complete, the Disk File Manager will 
allocate additional RAM for the creation of sector buffers. 
Sector buffers are allocated based upon information in the boot 
record as shown below: 


Byte 9 = maximum number of open files; one buffer per (the 
maximum value is &>. 


Byte 10 = drive select bits: one buffer per (1-4 only?. 
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The Disk File Manager will then insert the name D and the Handler 
vector table address in the device table. 


NOTE: There is a discrepancy between the Disk File Manager ’s 
numbering of diskette sectors (0-719) and the disk controller’s 
numbering of diskette sectors (1-720); as a result, only sectors 
i- 719 are used by the Disk File Manager. 


The Disk File Manager uses the Disk Handler to perform all 
diskette reads and writes; the DFM’s function is to support and 
maintain the directory/file/bitmap structures as described in the 
following pages: 
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FMS Biskette Utilization 


The map below shows the diskette sector utilization for a 


standard 720 sector diskette. 


ne ee ce a ee ne ae ae ane ee - 
H BOOT record i Sector 
pa + 
H FMS BOOT ‘ Sector 
= file = 
H bos. SYS i Sector 
a ee + 
i User i Sector 
= File = 
H Area i Sector 
$a + 
t VTOC (note 2) } Sector 
ee a en ee ne ee + 
H File { Sector 
= Directory = 
i i Sector 
pee a + 
H User H 
= File = 
H Area t Sector 
a a ea ee + 
i unused H Sector 
a ca ee ee ee ee + 


1 


359 
340 
361 


368 


771i? 


720 


Figure S-il File Management Subsystem Diskette 


Map 


_+ 


+- Note i 


t 
t 


—+ 
($167) 
($168) 
($149) 


($170) 


($2CF } 


($2D0} 


Sector Utilization 


NOTE i - If the diskette is not a system diskette, then your 

File Area starts at sector 2 and no space is reserved for the FMS 
BOOT file. However, "DOS" (BOS. SYS and DUP. SYS} may still be 
written to a diskette that has already used sectors “2-N. " 


NOTE 2 -- VTOC stands for Volume Table of Contents. 
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FMS Boot Record Format 


The FMS BOOT record (sector #1) is a special case of diskette-booted 
software (see Section 10). The format for the FMS BOOT record is 
shown below: 


a ee en cn a a me ae + 

i boot flag = O | Byte 0 

pe ee + 

i # sectors = 1 H i 

a a ne a + 

H boot address H oe 

+ + 

H = 06700 H 

he + 

H init address H 4 

+ + 

i H 

a a a ee eee en ee + 

H JMP = $48 H & 

+ + 

H boot read H 

+ continuation + 

H address i 

oe - ey} 

i max files = 3 3 i 9 Note i 
tenn + 

it drive bits = 1 | i 10 Note 2 
pr + i 

t alloc dire = O | i 1i Note 3 
pn ee + ' 

i boot image end | i 

+ + i FMS 
i address + 1 H +o ee eee configuration 
Se i a a + { data 
i boot flag <> O | H 14 Note 4 
: clanestateeaaataeteereamenter + { 

H sector count H H 15 Note § 
paren en a et er nee ee + { 

H DOS. SYS H H 

+ starting + i 

i sector number H H 

ee + m+ 


t 


it code for second: 
i phase of boot : 


Figure 5-12 File Management Subsystem Boot Record Format 
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NOTE i 


NOTE 2 


NOTE 3 


NOTE 4 


NOTE S$ 


Byte ? specifies the maximum number of concurrently open 
files to be supported. This value can range from 1 to &. 


Byte 10 specifies the specific disk drive numbers to be 
supported using a bit encoding scheme as shown below: 


765423210 
a pm ph mp pe pe pe 

H i4iSi@ii! where a il indicates a selected drive. 
pa pp — 


Byte 11 specifies the buffer allocation direction, this 
byte should equal O. 


Byte 14 must be nonzero for the second phase of the boot 
process to initiate. This flag indicates that the file 
DOS. SYS has been written to the diskette. 


This byte is assigned as being the sector count for the 
DOS. SYS file. It is actually an unused byte. 
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Boot Process Memory Map 


The diagram below shows how the boot sector (part of file 
DOS. SYS) and following sectors are loaded to memory as part of 
the boot process. 


Sp re re ee me mee + Memory address 0700 
i data from boot ! H 

= sector read by = i 

i! resident OS H 077C 
a co ee ee + 

i data from rest | 677DB 
i of DOS. SYS i i 

i read by the i H 

= program in the = H 

i boot sector. H i 
a ee + end of boot 


Figure 5-13 File Management Subsystem Boot Process Memory Map 
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Volume Table of Contents 


The format for the FMS volume table of contents (VTOC, sector 
360) is shown in the diagram below: 


number of (lo} 
sectors 
available (hi) 


Geum CONEY cuneD CEND yyy GREED CURED GteD CODED atoms GOTO enete een SIE OmSeD conte 


> 
i Byte QO Note i 
+ 

i 1 Note 2 
+ 

+ 

i 3 Note 3 
> 

+ 

+> 

H 10 

> 

+ 


Figure 5-14 File Management Subsystem Volume Table of Contents 


The volume bit map organization location follows: 


7 


0 


Saeki sei dee ceania steate aents aeete seae 


tet ta pat tt 
igg?. 


~~ 


it2345 467 


+4 4-4 $4 


ti-- nn + 


Byte 10 of VTOC 
ii 


99 


Figure 5-15 File Management Subsystem Volume Bit Map 


At each map bit position. a O indicates the corresponding sector 


is in use and a il indicates 


NOTE i —- The directory type 


NOTE 


2 ~ The maximum sector 
incorrectly set to 
number is actually 


that the sector is available. 
byte must equal O. 
number is not used because it is 


709 decimal. The true maximum sector 
71i9 for the BFM. 
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NOTE 3 - The number of sectors available is initially set to 709 
after a diskette is freshly formatted; this number is 
adyusted as files are created and deleted to show the 
number of sectors available. The sectors that are 
initially reserved are 1 and 3460-348. 


File Directory Format 


The FMS reserves eight sectors (361-368) for a file directory. 
Each sector containing directory information for up to eight 
files, thus providing for a maximum of 64 files for any volume. 
The format of a single 16-byte file entry is shown below: 


. eeneuaetantantententantenteetentemteeteaten + 
‘ flag byte i Byte O 
he ee ee ee + 

t sector (lod { 1 
+ count + 

i (hid [ 

hn ee + 

i starting (lo) ! a 
+ sector + 

i number (hid { 

pe a ee + 

i (1) ¢ 3 
+ + 

H (2) | 

+ + 

H (3) 

> + 

i file (4) 

+ + 

‘ name (5) { 

+ + 

i primary (4) |! 

+ + 

i (7) 3 

+ + 

H (8) ¢$ 
Se + 

H file (1) ¢ 13 
+ + 

H name (2) $ 

+ + 

i extension (3) $[ 

. aeeateestaaientanteententeestanteatentantanmententen + 


Figure 5-16 File Directory Format 


Where the flag byte has the following bits assigned: 
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bit 7 = 1 if the file has been deleted. 
bit &6 = 1 if the file is in use. 

bit 5 = 1 if the file is locked. 

bit O© = 1 if OPEN output. 


The flag byte can take on the following values: 


$00 = entry not yet used (no file). 

$40 = entry in use (normal CLOSEd file>. 
$41 = entry in use (OPEN output file). 

$40 = entry in use (locked file}. 

$80 = entry available (prior file deleted}. 


Sector count is the number of sectors comprising the file. 


FMS File Sector Format 


The format of a sector in your data file is shown below: 


7 0 
ttt tt ttt 

i data i +0 

H i 
++ —t$— 4-4-4 —- 4-4 —-4+ 

i file # thi i +4125 
tot 4 — + + 
iforward pointer: +126 
tat te pe bt ttt 

iSt byte count : +127 
Seal Aimee teas stents staata ten ate ae 


Figure 5-17 File Management Subsystem File Sector Format 


The FMS uses the file # to verify file integrity. The file # 

is a redundant piece of information. The file number field 
contains the value of the directory position of that file. If a 
mismatch occurs between the file’s directory position, and the 
file number as contained in each sector, then the DFM will 
generate the error $A4. 


The forward pointer field contains the 10-bit value for the 
diskette sector number of the next sector of the file. The 
pointer equals zero for the last sector of a file. 


The S bit indicates whether or not the sector is a “short sector" 
(a sector containing fewer than 125 data bytes). S is equal to 
i when the sector is short. 
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The byte-count field contains the number of data bytes in the 
sector. 


Non-CI0O 1/0 


Some portions of the I/0 subsystem are accessed independently of 
the Central I/0 Utility (CIO); this section discusses those 
areas. 


Resident Device Handler Vectors 


All of the OS ROM resident device handlers can be accessed via 
sets of vectors that are part of the 0S ROM. These vectors 
increase the speed of I/O operations that utilize fixed device 
assignments, such as output to the Display Handler. For each 
resident Handler there is a set of vectors ordered as shown 
below: 


. etententetantambententieteetertentaatatond + 

+- OPEN -+ +0 
me me ee + 

+- CLOSE -+ +2 
pn ee a ee ee + 

+- GET BYTE -+ +4 
Fr ee ee + 

+- PUT BYTE —+ +6 
a a ee + 

+- GET STATUS -+ +8 
ee ae ee ne ca ee ee eee ee + 

+- SPECIAL -+ +10 
pe me a a + 

+- JMP —+ +12 
+- INIT -+ 

em me ce ee a ee + 

+- SPARE _+ 

+- BYTE -+ 

Sp a + 


Figure 5-18 Resident Device Handler Vectors 


See Section 9? for a detailed description of the data interface 
for each of these Handler entry points. 


Each of the vectors contains the address (lo, hi? of the Handler 
entry point minus 1. A technique similar to the one shown below 
is Tequired to access the desired routines: 
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VTBASE=$E400 i BASE OF VECTOR TABLE. 


LDX #x x + OFFSET TO DESIRED ROUTINE. 


LDA data 
JSR GOVEC ; SEND DATA TO ROUTINE. 
LDX #yy ; OFFSET TO DIFFERENT ROUTINE. 
JSR GOVEC ; GET DATA FROM ROUTINE. 
STA data 

GOVEC TAY ; SAVE REGISTER A. 
LDA VTBASE+1, X ; ADDRESS MSB TO STACK. 
PHA 
LDA VTBASE, X ; ADDRESS LSB TO STACK. 
PHA 
TYA ; RESTORE REGISTER A. 
RTS ; JUMP TO ROUTINE. 


The JMP INIT slot in each set of vectors jumps to the Handler 
initialization entry (not minus 1). 


The base address of the vector set for each of the resident 
handlers is shown below: 


Screen Editor (E: } E400. 
Display Handler (S: > E410. 
Keyboard Handler (K:> E420. 
Printer Handler (P: >} E430. 
Cassette Handler (C:) E440. 


The resident diskette Handler is not CliO-compatible, so its 
interface does not use a vector set. 


Resident Diskette Handler 


The resident Diskette Handler (not to be confused with the Disk 
File Manager) is responsible for all physical accesses to the 
diskette. The unit of data transfer for this Handler is a single 
diskette sector containing 128 data bytes. 


Communication between you and the Diskette Handler is 

effected using the system’s Device Control Block (DCB), that is 
also used for Handler/SIO communication (see Section 9). The DCB 
is 12 bytes long. Some bytes are user-alterable and some are for 
use by the Diskette Handler and/or the Serial I/O Utility (SIO). 
You supply the required DCB parameters and then do a JSR 

DSKINV CE453]. 
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Each of the DCB bytes will now be described, and the 
system-equate file name for each will be given. 

SERIAL BUS ID -- DDEVIC [0300] 

The Diskette Handler sets up this byte to contain the Serial Bus ID 
for the drive to be accessed. It is not user-alterable. 

DEVICE NUMBER -- DUNIT (03011 

You set up this byte to contain the disk drive number to be 
accessed (i -— 4). 

COMMAND BYTE -- DCOMND (0302) 

You set up this byte to contain the disk device command to 

be performed. 

STATUS BYTE -- DSTATS [£0303] 

This byte contains the status of the command upon return to the 
caller. See Appendix C for a list of the possible status codes. 
BUFFER ADDRESS -- DBUFLO £0304] and DBUFHI [0305] 

This 2-byte pointer contains the address of the source or 
destination of the diskette sector data. You need not supply 

an address for the disk status command. The Disk Handler will 
obtain the status and insert the address of the status buffer 
into this field. 

DISK TIMEOUT VALUE -- DTIMLO [0306] 

The Handler supplies this timeout value (in whole seconds) for 
use by SIO. 

BYTE COUNT -- DBYTLO [0308] and DBYTHI (C0309) 

This 2-byte counter indicates the number of bytes transferred to 
or from the disk as a result of the most recent command, and is 
set up by the Handler. 

SECTOR NUMBER -- DAUX1 COSOA] and DAUX2 COSOB] 


This 2-byte number specifies the diskette sector number (1 ~- 720) 
to read or write. DAUX1 contains the least significant byte, and 
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DAUX2 contains the most significant byte. 


Diskette Handler Commands 
There are five commands supported by the Diskette Handler: 
GET SECTOR (PUT SECTOR —-### not supported by current handler #**) 
PUT SECTOR WITH VERIFY 


STATUS REQUEST 
FORMAT DISK 


GET SECTOR (Command byte = $52) 
The Handler reads the specified sector to your buffer and returns the 
operation status. You set the following DCB parameters prior to 
calling the Diskette Handler: 

COMMAND BYTE = $52. 

DEVICE NUMBER = disk drive number (1-4}. 

BUFFER ADDRESS = pointer to your 126-byte buffer. 

SECTOR NUMBER = sector number to read. 
Upon return from the sector, several of the other DCB parameters 
will have been altered. The STATUS BYTE will be the only 
parameter of interest to you, however. 


PUT SECTOR (Command byte = $50) 


###% Not supported by current Handler #++ 
(But can be accessed through SIO directly. > 


The Handler writes the specified sector from your buffer and returns 
the operation status. You set the following DCB parameters prior to 
calling the Diskette Handler: 

COMMAND BYTE = $50. 

DEVICE NUMBER = disk drive number (1-4). 

BUFFER ADDRESS = pointer to your 128 byte buffer. 

SECTOR NUMBER = sector number to write. 
Upon return from the operation, several of the other DCB parameters 
will have been altered. The STATUS BYTE will be the only one of 


interest you, however. 
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PUT SECTOR WITH VERIFY (Command Byte = $57) 


The Handler writes the specified sector from your buffer 

and returns the operation status. This command differs from PUT 
SECTOR in that the diskette controller reads the sector data after 
writing to verify the write operation. Aside from the COMMAND 

BYTE value, the calling sequence is identical to PUT SECTOR. 


STATUS REQUEST (Command byte = $53) 


The Handler obtains a 4-byte status from the diskette controller and 
puts if in system location BDVSTAT CO2EA]. The operation status 
format is shown below: 


7 QO 
ee oe oe oe oe a So So 
§ command stat. 
$e 
| hardware stat. 
$e 
H timeout 
ee ee on on on ae ce oo 
i Cunused} 
$a pp a pe pe 


DVSTAT + 0 


oe ee See 


Figure 5-19. BVSTAT 40-Byte Operation Status Format 


The command status contains the following status bits: 


Bit O = 1 indicates an invalid command frame was received. 
Bit 1 = 1 indicates an invalid data frame was received. 
Bit 2 = 1 indicates that a PUT operation was unsuccessful. 
Bit 3 = 1 indicates that the diskette is write protected. 
Bit 4 = 1 indicates active/standby. 


The hardware status byte contains the status register of the 
INS1771-1 Floppy Diskette Controller chip used in the diskette 
controller. See the documentation for that chip to obtain 
information relating to the meaning of each bit in the byte. 


The timeout byte contains a controller-provided maximum timeout 
value (in seconds) to be used by the Handler. 


You set the following DCB parameters prior to calling 
the Diskette Handler: 


COMMANB BYTE = $53. 
DEVICE NUMBER = disk drive number (1-4). 


Upon return from the operation, several of the other DCB parameters 
will have been altered. The STATUS BYTE will be the only one of 


OPERATING SYSTEM CO16555 -- Section § 
100 


interest to you, however. 


FORMAT DISK (Command Byte = $21) 


The Handler commands the diskette controller to format the entire 
diskette and then to verify it. All bad sector numbers (up to a 
maximum of 63) are returned and put in the supplied buffer, 
followed by two bytes of all 1's ($FFFF). You set up the 
following DCB parameters prior to calling the Diskette Handler: 


COMMAND BYTE = $21. 
DEVICE NUMBER = disk drive number (1-4). 
BUFFER ADDRESS = pointer to your 128-byte buffer. 
Upon return, you might be interested in the following DCB parameters: 
STATUS BYTE = status of operation. 


BYTE COUNT = number of bytes of bad sector information in 
your buffer, not including the S$FFFF terminator. If there 
are no bad sectors, the count will equal zero. 


Serial Bus 1/0 


Input/Output to devices other than the keyboard, the screen, and 
the ATARI Computer controller port devices, must utilize the 
Serial [1/0 bus. This bus contains data, control, and clock lines 
to be used to allow the computer to communicate with external 
devices on this “daisychained" bus. Every device on the bus has 
a unique identifier and will respond only when directly 
addressed. 


The resident system provides a Serial I/0 Utility (SIO), that 
provides a standardized high-level program interface to the bus. 
SIO is utilized by the resident Diskette, Printer, and Cassette 
handlers, and is intended to be used by nonresident handlers (see 
Section 9}, or by applications. as well. For a detailed 
description of the program/SIO interface and for a detailed bus 
specification refer to Section 9. 
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& INTERRUPT PROCESSING 


Section 6& describes system actions for the various interrupt 
causing events, defines the many RAM vectors and provides 
recommended procedures for dealing with interrupts. 


The 6502 microcomputer processes three general interrupt types: 
chip-reset, nonmaskable interrupts (NMI) and maskable interrupts 
(IRQ). The IRG interrupt type can be enabled and disabled using 
the 6502 CLI and SEI instructions. The NMI type cannot be 
disabled at the processor level; but the NMI interrupts other 
than CSYSTEM. RESET] key can be disabled at the ANTIC chip. 


The system events that can cause interrupts are listed below: 
chip-reset - power-up 


NMI - Display list interrupt (unused by OS? 
vertical-blank (50/60 Hz) 
CSYSTEM. RESET] key 


IR@ - Serial bus output ready 
Serial bus output complete 
Serial bus input ready 
Serial bus proceed line (unused by system} 
Serial bus interrupt line (unused by system) 
POKEY timers 1,2 and 4 
Keyboard key 
CBREAK] key 
6502 BRK instruction (unused by OS) 


Figure 6-1 List of System-Interrupt Events 
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The chip-reset interrupt is vectored via location FFFC to E477, 
where a JMP vector to the power-up routine is located. All NMI 
interrupts are vectored via location FFFA to the NMI interrupt 
service routine at E7B4, and all IRQ interrupts are vectored 
via location FFFE to the IR@ interrupt service routine at E6F3; 
at that point the cause of the interrupt must be determined by 
a series of tests. For some of the events there are built in 
monitor actions and for other events the corresponding 
interrupts are disabled or ignored. The system provides RAM 
vectors so that you can intercept interrupts when 

necessary. 


CHIP-RESET 


The OS generates chip-reset in response to a power-up condition. 
The system is completely initialized (see Section 7). 


NONMASKABLE INTERRUPTS 


When an NMI interrupt occurs, control is transferred through 

the ROM vector directly to the system NMI interrupt service 
routine. A cause for the interrupt is determined by examining 
hardware register NMIST CD40F]. The NMI makes a yump through the 
global RAM vector VDSLST (C(O200] if a display list interrupt is 
pending. The OS does not use display list interrupts, so VDSLST 
is initialized to point to an RTI instruction. and you must not 
change it before VDSLST generates a display interrupt. 


If the interrupt is not a display-list interrupt, then a test is 
made to see if it is a CSYSTEM. RESET] key interrupt. If so, then a 
Jump is made to the system reset initialization routine (see Section 
7 for details of system reset initialization}. 


If the interrupt is neither a display list interrupt nor a 
CSYSTEM. RESET] key interrupti then it is assumed to be a 
vertical-blank (VBLANK) interrupt, and the following actions 
occur: 
Registers A,X and Y are pushed to the stack. 
The interrupt request is cleared (NMIRES CD40F]>. 
A sump is made through the “immediate"™ vertical-blank global 
RAM vector VVBLKI (CO222] that normally points to the Stage 1 
VBLANK processor. 
The following actions occur assuming that you have not changed VVBLKI. 
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The stage 1 VBLANK processor is executed. 


The OS tests to see if a critical code section has been 
interrupted. If so; then all registers are restored, and an 
RTI instruction returns from the interrupt to the critical 
section. A critical section is determined by examining the 
CRITIC flag £0042], and the processor I bit. If either are 
set, then the interrupted section is assumed to be critical. 


If the interrupt was not from a critical section, then the 
stage 2 VBLANK processor is executed. 


The OS then jumps through the “deferred" vertical-blank 
global RAM vector VBLKD [0224], that normally points to the 
VBLANK exit routine. 


The following actions occur assuming that you have not changed VVBLKD. 
o The 6502 A.X and Y registers are restored. 


o An RTI instruction is executed. 


NOTE: You can alter the deferred and immediate 

VBLANK RAM vectors, but still enable normal system processesi or 
restore original vectors without having to save them. The 
instruction at E45F is a JMP to the stage 1 VBLANK processori the 
address at C£460,2] is the value normally found in VVBLKI. The 
instruction at E462 is a JMP to the VBLANK exit routine: the 
address at [F&443,2] is the value normally found in VVBLKD. These 
ROM vectors to stage i VBLANK processor and to the VBLANK exit 
routine will accomplish your goal. 


NOTE: Every VBLANK interrupt jumps through vector VVBLKI. Only 
VBLANK interrupts from noncritical code sections jump through 
vector VVBLKD.. 


Stage 1 VBLANK Process 


The following stage 1 VBLANK processing is performed at every 
VBLANK interrupt: 


The stage 1 VBLANK process increments the S-byte frame 
counter RTCLOK £0012-0014]; RTCLOK+0 is the MSB and RTCLOK+2 
is the LSB. This counter wraps to zero when it overflows 
(every 77 hours or so}, and continues counting. 


The Attract mode variables are processed (sea Appendix L, 
B1i0-123. 


The stage i VBLANK process decrements the System Timer 1 
CDTMVi £0218,2] if it is nonzero; if the timer goes from 
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nonzero to zero then an indirect JSR is performed via CDTMA1 
£0226, 2]. 


Stage 2 VBLANK Process 


The stage 2 VBLANK processing performs the following for those 
VBLANK interrupts that do not interrupt critical sections: 


The stage 2 VBLANK process clears the 6502 processor I bit. 
This enables the IRG@ interrupts. 


The stage 2 VBLANK process updates various hardware 
registers with data from the OS data base, as shown below: 


Data Base Hardware Reason for Update 
Item Register 

SDLSTH £0231] DLISTH €D4033 Display list start 
SDLSTL £0230] DLISTL CD402] 

SDMCTL €G22F] DMACTL CD400] 

CHBAS [fO02F4] CHBASE [D409] 

CHACT (CO2F3] CHACTL [£D401] 

GPRIOR £O026F] PRIOR CDO1BI 

COLORO £02C4] COLPFO £DO16] Attract mode. 
COLORI CO2CS5] COLPF1 (CDO1i17) 

COLOR2 £02C46} COLPF2 £D0i8] 

COLORS (02C7] COLPFS3 (€DO19] 

COLOR4 £02C8]} COLBK (CDOIAI 

PCOLRO [£G2CO] COLPMO (CDOi2 

PCOLR1 (£O02C1] COLPM1 [CDOi3] 

PCOLR2 £02C2] COLPM2 CDO1i4] 

PCOLRS £O02C3] COLPMS3S ([DOi5S] 

Constant = 8 CONSOL CDOIF] Console speaker off. 


The stage 2 VBLANK process decrements the System Timer 2 
CDIMV2 [CO21A.2] if it is nonzero; if the timer goes from 
nonzero to zero, then an indirect JSR is performed 
through CBDTMA2 (0228, 21. 


The stage 2 VBLAMK process decrements System Timers 3. 4 and 


S if they are nonzero: the corresponding flags are set to 
zero for each timer that changes from nonzero to zero. 
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Timer Timer Value Timer Flag 
3 CBTMVS3 CO21C, 2) 
4 CDIMV4 CO2iE, 2] 


2 CDTMVS (CO220, 2] 


CDTMFS CO22A, 1] 
CDTMF4 CO22C, 1] 
CDTMFS CO22E, 1] 


A character is read from the POKEY keyboard register and 
stored in CH CO2FC], if auto repeat is active. 

The stage 2 VBLANK process decrements the keyboard pehounce 
counter if it is not equal to zero, and if no key is 


pressed. 


The stage 2 VBLANK process processes the keyboard auto 
repeat (see Appendix L., ES8>. 


The stage 2 VBLANK process reads game controller data from 


the hardware to the RAM data base, 


as shown below: 


Hardware Data Base Function 
Register Item 
PORTA (D300) STICKO £0278] Joysticks and 
STICKI £0279] 
PTRIGO (€027C} Paddle Controllers 
PTRIGI (€627D] 
PTRIG2 (CO27E] 
PTRIGS [£O027F] 
PORTB (CD3O01] STICK2 [027A] 
STICKS (€027B} 
PTRIG4 [0280] 
PTRIGS CO281] 
PTRIG6 C0282) 
PTRIG7 C0283) 
POT G [D200] PADDLO £0270] Paddle Controllers 
POT i [{D201] PADDL1 [0271] 
POT 2 (D202) PADDL2 [£0272] 
POT 3 [D203) PADDLS [0273] 
POT 4 [£D204) PADDL4 £0274] 
POT 5S f£D205) PABDDLS (0275) 
POT & [D206] PADDL46 [0276] 
POT 7 {£D2073 PADDL7 [0277] 
TRIGO £D001] STRIGO C0284] Joystick triggers. 
TRIGi (CDBOO2) STRIGI [£0285] 
TRIG2 fCDOO3I STRIG2 C0286] 
TRIGS [CDOO4] STRIGS £06287] 
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MASKABLE INTERRUPTS 


An IRG@ interrupt causes control to be transferred through the 

immediate IRG@ global RAM vector VIMIRG@ CO216]. Ordinarily this 
vector points to the system IRQ Handler. The Handler performs 

these following actions: 


The IR@ Handler determines a cause for the interrupt by 

examining the IRQST CD20E] register and the PIA status 

registers PACTL C(D302] and PBCTL CDGOS]. The interrupt status bit 
is cleared when it is found. One interrupt event is cleared and 
processed for each interrupt-service entry. If multiple IRQ@s are 
pending, then a separate interrupt will be generated for each 
pending IRQ. until all are serviced. 


The system IRQ interrupt service routine deals with each of the 
possible IRQ causing events, in the following ways: 


o The 6502 A register is pushed to the stack. 


o If the interrupt is due to serial 1/0 bus output ready, 
then clear the interrupt and jump through global RAM 
vector VSEROR (CO20C]. 


0 If the interrupt is due to serial I/0 bus input ready, 
then clear the interrupt and jump through global RAM 
vector VSERIN [CO2CAI. 


o If the interrupt is due to serial I/0 bus output 
complete, then clear the interrupt and jgump through 
global RAM vector VSEROC CO20OE]. 


9 If the interrupt is due to POKEY timer #1, then clear the 
interrupt and jump through global RAM vector VTIMR1 £0210]. 


rs) If the interrupt is due to POKEY timer #2, then clear the 
interrupt and jump through global RAM vector VTIMR2 [0212]. 


o If the interrupt is due to POKEY timer #4, then clear the 
interrupt. The service routine contains a bug, and falls 
into the following test. 


3) If pressing a keyboard key caused the interrupt (other 
than CBREAK], CSTART], COPTION], or CSELECTI]>}; then clear the 
interrupt and jump through global RAM vector VAKEYBD CO208]. 


o If pressing the CBREAK] key caused the interrupti then 
clear the interrupt. Set the BREAK flag BRAKEY COO11] to 
zero, proceed to clear the following: 


Start/stop flag SSFLAG CO2FF] 
Cursor inhibit flag CRSINH CO2FO 
Attract mode flag ATRACT COO04D] 
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Return from the interrupt after restoring the 46502 4 
register from the stack. 


fs) If the interrupt is due to the serial I/O bus proceed line; 
then clear the interrupt, and gump through global RAM vector 
VPRCED C0202]. 


ra) If the interrupt is due to the serial I/0 bus interrupt 
line, then clear the interrupt and jump through global RAM 
vector VINTER [0204]. 


ra) If the interrupt is due to a 6502 BRK instruction, then jump 
through global RAM vector VBREAK [(06204]. 


o If none of the above, restore the 6502 A register and return 
from the interrupt (RTI). 


INTERRUPT INITIALIZATION 


The interrupt subsystem completely reinitializes itself whenever 
the system is powered up or the CSYSTEM. RESET] key is pressed. 
The OS clears the hardware registers, and sets the interrupt 
global RAM vectors to the following configurations: 


Vector Type Function 

VDSLST £0200] NMI RTI -- ignore interrupt. 

VVBLKI [0222] " System stage i VBLANK. 

CDTMA1 [£02267 bs SIO timeout timer. 

CDTMA2 [0228] No system function. 

VVBLKD £0224] s System return from interrupt. 

VIMIRQG (0214) IRG System IRQ processor. 

VSEROR [£020C] “ Sto. 

VSERIN [CO20A] " sio. 

VSEROC CO20E] " Sio. 

VTIMRi £0210] ie PLA, RTI -- ignore interrupt. 

VTIMR2 CO212) " PLA, RTI -- ignore interrupt. 

VTIMR4 £0214] " H### doesn’t matter ##+# 

VAEYBD £0208) : System keyboard 

interrupt handler. 

VPRCED [£0202] sa PLA,RTI -- ignore interrupt. 

VINTER £0204} se PLA,RTI ~-- ignore interrupt. 

VBREAK £0206] BRK PLA, RTI -- ignore interrupt. 
Figure 6-2 Interrupt RAM Vector Initialization 


OPERATING SYSTEM CO146555 -- Section 6 
108 


System initialization sets the interrupt enable status 
as follows: 


NMI VBLANK enabled, display list disabled. 


IRG CBREAK] key and data key interrupts enabled, 


disabled. 


all others 


SYSTEM TIMERS 


The OS contains five general purpose software timers, plus an 
OS-supported frame counter. The timers are 2 bytes in length 
(lo, hi} and the frame counter RTCLOK (CO012] is three bytes in 
Length (hi.mid, lo}. The timers count downward from any 
nonzero value to zero. Upon reaching zero, they either clear 
an associated flag: or JSR through a RAM vector. The frame 
counter counts upward, wrapping to zero when it overflows. 


The following table shows the timers and the frame counter 
characteristics: 


Timer Name Flag/Vector Use 
# CDTMV1 C0218] CDTMA1L [0226] 2-byte vector -- SIO timeout. 
CDTMV2 £O21A] CDITMA2 CO228] 2-byte vector 
CDTMV3 £021C] CDITMFS CO22A] i-byte flag 
CDTMV4 CO21E] CDTMF4 CO22C] i-byte flag 
CDTMVS C0220] CDIMFS CO22E] i-byte flag 
+ RTCLOK £0012] S-byte frame counter. 


* These two timers are maintained as part of every VBLANK 
interrupt (stage 1 process}. The other timers are subject to 
the critical section test (stage-2 process}, that can defer 
their updating to a later VBLANK interrupt. 


USAGE NOTES 


This subsection describes the techniques you need to know in 


order to utilize interrupts in conyunction with the operating 
system. 
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POKEY Interrupt Mask 


ANTIC (display-list and vertical-blank?) and PIA (interrupt and 
proceed lines} interrupts can be masked directly (see the 
Hardware Manual). However, eight bits of a single byte IRGEN 
CD20E] mask the POKEY interrupts (CBREAK] key. data key, 
serial input ready, serial output ready, serial output done 
and timers 1,2 and 4}. 


IRGEN is a write-only register. Thus, we must maintain a 
current value of that register in RAM in order to update 
individual mask bits selectively, while not changing other bits. 
The name of the variable used is POKMSK COO10], and it is used 
as shown in the examples below: 


i EXAMPLE OF INTERRUPT ENABLE 


SETI i TO AVOID CONFLICT WITH IRG ... 
LDA POKMSK i ... PROCESSOR WHICH ALTERS VAR. 
ORA €$ x x i ENABLE BIT(S). 

STA POKMSK 

STA IRGEN i TO HARDWARE REG TOO. 

CLI 


i EXAMPLE OF INTERRUPT DISABLE 


SETI i TO AVOID CONFLICT WITH IRG ... 
LDA POKMSK ; ... PROCESSOR WHICH ALTERS VAR. 
AND #$FF-xx i; DISABLE BIT(S>). 

STA POKMSK 

STA IRGEN i TO HARDWARE REGISTER TOO. 

CLI 


Figure 6-3 POKEY Interrupt Mask Example 


Note that the OS IRG@ service routine uses and alters POKMSK, so 
alterations to the variable must be done with interrupts 
inhibited. If done at the interrupt level there is no problem as 
the I bit is already set; if done at a background level then the 
SEI and CLI instructions should be used as shown in the examples. 


Setting Interrupt and Timer Vectors 


Because vertical-blank interrupts are generally kept enabled so that 
the frame counter RTCLOK is maintained accurately, there is a 
problem with setting the VBLANK vectors (VVBLKI and VVBLKD) or 

the timer values (CDTMV1 through CDTMVS) directly. A VBLANK 
interrupt could occur when only one byte of the two-byte value had 
been updated, leading to undesired consequences. For this reason, 
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the SETVBV 


CE4SF] routine is provided to perform the desired 


update in safe manner. The calling sequence is shown below: 


< 
i tf 


JSR 


The 
The 


update item indicator 

1 - 5 for timers 1 - §. 

& for immediate VBLANK vector VVBLKI. 
7 for deferred VBLANK vector VVBLKB. 
MSB of value to store. 

LSB of value to store. 


SETVBV 


A,X and Y registers can be altered. 
display list interrupt will always be disabled on 


return, even if enabled upon entry. 


It is possible to fully process a vertical-blank interrupt 
during a call to this routine. 


When working with the System Timers, the vectors for timers 1 and 
2 and the flags for timers 3.4 and 5S should be set while the 


associated 


timer is equal to zero, then the timer should be set 


to its (nonzero) value. 


Stack Content at Interrupt Vector Points 


The following table shows the stack content at every one of the 
RAM interrupt vector points: 
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INTERRUPT VECTOR DESCRIPTION 
VDSLST £0200] Display list return, P 
VVBLKI CO222] * VBLANK immediate return, P, A, X, Y 
CDTMA1 £0226] System Timer 1 return, P, A, X, Y, 
CDTMA2 £0228) System Timer 2 return, P, A, X. Y, 
VVBLKD [0224] + VBLANK defer. return, P, A, X, ¥ 
VIMIR@ £6216] + IRG@ immediate return, P, A 
VSEROR £020C] + Serial out ready return, P, A 
VSERIN CO20Al] +# Serial in ready return, P., A 
VSEROC £O20E] +# Serial out compare return, PP, A 
VTIMR1 C0210] POKEY timer 1 return, P. A 
VTIMR2 £0212] POKEY timer 2 return, P, A 
VTIMR4 £0214] POKEY timer 4 return, P, A 
VKEYBD CO208] + Keyboard data return, P, A 
VPRSED £0202] Serial proceed return, P. A 
VINTER £0204] Serial interrupt return, P, A 
VBREAK £0206] BRK instruction return, P. A 
Figure 6-4 Interrupt and Timer Vector RAM Stack Content Table 


RAM STACK CONTENT 


OS RETURN CONTROL 


* The OS initializes these entries at power-up. Improperly 
changing these vectors will alter system performance. 


Miscellaneous Considerations 


The following paragraphs list a set of miscellaneous 
considerations for the writer of an interrupt service routine. 


Restrictions on Clearing of "I" Bit 


Display list, immediate vertical-blank and System Timer #1 
routines should not clear the 6502 I bit. If the NMI leading to 
one of these routines occurred while an IR@ was being processed, 
then clearing the I bit will cause the IR@ to re-interrupt with 
an unknown result. 


return 
return 


The OS VBLANK processor carefully checks this condition after the 


stage 1 process and before the stage 2 process. 


Interrupt Process Time Restrictions 


You should not write an interrupt routine that exceeds 400 msec. 
when added to the stage 1 VBLANK, if the serial I/O is being 
used. The SIO sets the CRITIC flag while serial bus I/0 is in 
progress. 
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Interrupt Delay Due to “WAIT FOR SYNC" 


Whenever a key is read from the keyboard, the Keyboard Handler 
sets WSYNC £€D40A] repeatedly while generating the audible click 
on the console speaker. A problem occurs when interrupts are 
generated during the wait-for-sync period; the processing of such 
interrupts will be delayed by one horizontal scan line. This 
condition cannot be prevented. You can work around the condition 
by examining the line count VCOUNT [D40B] and delaying interrupt 
processing by one line when no WSYNC delay has occurred. 


FLOWCHARTS 


The following pages contain process flowcharts showing the main 
events that occur in the NMI and IRQ@ interrupt processes. 


| me IRQ INTERRUPT PROCESS 


POKEY Y CLEAR 
TIMER 2? STATUS 
N 
Y CLEAR KED 
REHOME pepe VKEYBD HANDLER 
N 
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CLEAR STATUS, 
SET BREAK FLG PULL A 
CLEAR S/S 
v CLEAR 
parents VPRCED 
sf CLEAR VINTER 
STATUS 
Y 
VBREAK 


SERIAL 
PROCEED? 


SERIAL 
INTERR.? 


N 
BRK 
INSTRUCT? 


PULL REG A 
FROM STACK 
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NMI INTERRUPT PROCESS 


VDSLST 


DISPLAY Y 
LIST? 
N 


PUSH REG A 
TO STACK 


VERTICAL 
BLANK? 


PUSH X & Y, 
CLEAR STATUS 


VVBLKI 


CRITICAL. 


SECTION? 
N 
ce gs cat iis aa 


RESTORE 
REGISTERS 
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7 SYSTEM INITIALIZATION 


Section 7 discusses the details of the power-up and 
system reset processes. The power-up process will be explained 
first, and then the system reset process will be explained in 
terms of its differences from the power-up process. 


Both power-up (also called coldstart) and pressing CSYSTEM. RESET] 
(warmstart} will cause system initialization: In addition, there 
are vectors for these processes at E474 (system reset) and £477 
(power-up) so that they can be user-initiated. 


The power-up initialization process is a superset of the 

system reset initialization process. Power-up initializes both 
the OS and user RAM regions, whereas system reset initializes 
only the OS RAM region. In both cases, the OS calls the outer 
level software initialization entry points allow the application 
to initialize its own variables. 


Pressing the (CSYSTEM. RESET] key produces an NMI interrupt. It 
does not perform a 6502 chip-reset. If the processor is locked 


up, the CSYSTEM. RESET] key cannot be sufficient to unlock it, and the 
system must have power cycled to clear the problem. 


POWER-UP INITIALIZATION (COLDSTART) PROCEDURE 


The OS performs the following functions in the order shown, as 
part of the power-up initialization process: 


1. The following 6502 processor states are set: 


9) IR@ interrupts are disabled using the SEI instruction. 
2) The decimal flag is cleared using the CLD instruction. 
fa) The stack pointer is set to SFF. 


2. The OS sets the warmstart flag WARMST [0008] to OG (false). 
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10. 


11. 


The OS tests to see if a diagnostic cartridge is in the A slot: 
Cartridge address BFFC = 00? 
The memory at BFFC is not RAM? 


Bit 7 of the byte at BFFD = i? 


If all of the above tests are true, then control is passed to 
the diagnostic cartridge via the vector at BFFE. No return is 
expected. 


The OS determines the lowest memory address containing 
non-RAM. by testing the first byte of every 4K “block" to see 
if the content can be complemented. If it can be complemented, 
then the original value is restored and testing continues. If 
it can’t be complemented: then the content is assumed to be 
the first non-RAM address in the system. The MSB of the 
address is stored temporarily in TRAMSZ [C006]. 


Zero is stored to all of the hardware register addresses shown 
below (most of that aren’t decoded by the hardware): 


DOOC through DOFF 
D200 through DeFF 
D300 through DSFF 
D400 through BD4FF 


The OS clears RAM from location GCOS. to the address 
determined in step 4, above. 


The default value for the “noncartridge" control vector 
DOSVEC COOOA] is set to point to the blackboard routine. At 
the end of initialization, control is passed through this 
vector if a cartridge does not take control. 


The coldstart flag COLDST [0244] is set to -1 (local use). 


The screen margins are set: left margin = 2, right margin = 
39, for a 38 character physical line. The maximum line size of 
40 characters can be obtained by setting the margins to O and 
39. The OS insets the left margin because the two leftmost 
columns of the video picture on many television sets are not 
entirely visible on the screen. 


The interrupt RAM vectors VDSLST (CO200] through VVBLKD [CO224] 
are initialized. See Section 6 for the initialization values. 


Portions of the OS RAM are set to their required nonzero values 


as shoun below: 
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The CBREAK] key flag BRAKEY COO11] = -1 (false). 


The top of memory pointer MEMTOP COZES] = the lowest 
non-RAM address (from step 4); MEMTOP will be altered 
later when the Screen Editor is opened in step 15. 


The bottom of memory pointer MEMLO (C02E7] = 0700; MEMLO 
can be changed Later if there is either a diskette- or 
cassette-boot operation. 


The following resident routines are called for initialization: 


Screen Editor 

Display Handler 

Keyboard Handler 

Printer Handler 

Cassette Handler 

Central I/0 Monitor (CIO} 
Serial I/0 Monitor (SIO) 
Interrupt processor 


The CSTART] key is checked, and if pressed, the cassette-boot 
request flag CKEY CO04A] is set. 


6502 IRG interrupts are enabled using the CLI instruction. 


The device table HATABS [O3iA] is initialized to point to the 
Tesident handlers. See Section 9 for information relating to 
the Device Handler table. 


The cartridge slot addresses for cartridges B and A are 
examined to determine if cartridges are inserted, if RAM does 
not extend into the cartridge address space. 


If the content of location 9FFC is zero, then a JSR is 
executed through the vector at 9FFE, thus initializing 
cartridge "“B“. The cartridge is expected to return. 


If the content of location BFFC is zero, then a JSR is 
executed through the vector at BFFE, thus initializing 
cartridge "A". The cartridge is expected to return. 


IOCB #0 is set up for an OPEN of the Screen Editor (E>) and 
the OPEN is performed. The Screen Editor will use the highest 
portion of RAM for the screen and will adjust MEMTOP 
accordingly. If this operation should fail, the entire 
initialization process is repeated. 


A delay is effected to assure that a VBLANK interrupt has 
Occurred. This is done so that the screen will be established 
before continuing. 


If the cassette-boot request flag is set (see step 11 above), 
then a cassette-boot operation is attempted. See Section 10 


OPERATING SYSTEM CO016555 -- Section 7 


18. 


a: 


2O. 


for details of the cassette-boot operation. 


If any of the three conditions stated below exists, an 
attempt is made to boot from the disk. 


There are no cartridges in the slots. 
Cartridge B is inserted and bit O of GFFD is 1. 
Cartridge A is inserted and bit O of BFFD is 1. 

See Section 10 for details of the diskette-boot operation. 


The coldstart flag COLDST is reset to indicate that the 
coldstart process went to completion. 


The initialization process is now complete, and the 
controlling application is now determined via the remaining 
steps. 


If there is an A cartridge inserted and bit-2 of BFFD is 1, 
then a JMP is executed through the vector at BFFA. 


Or. if there is a B cartridge inserted and bit-2 of 9FFD is 
1, then a JMP is executed through the vector at FFA. 


Or, a gump is executed through the vector DOSVEC that can 
point to the blackboard routine (default case), cassette 
booted software or diskette booted software. DOSVEC can be 
altered by the booted software as explained in Section 10. 


SYSTEM RESET INITIALIZATION (WARMSTART) PROCEDURE 


The functions Listed below are performed, in the order shown, as 
part of the system reset initialization process: 


A. 


oh SE Gt ee 


Same as power-up step 1. 

The warmstart flag WARMST COOO0S] is set to -i (true?. 

Same as power-up steps 3 through 5. 

OS RAM is zeroed from locations O200-O3FF and 0010-007F. 
Same as power-up steps 9 through 16. 

If a cassette-boot was successfully completed during the 
power-up initialization, then a JSR is executed through the 


vector CASINI [C0002]. See Section 10 for details of the 
cassette-boot process. 
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G. Same as power-up step 18, except instead of booting the 
diskette software, a JSR is executed through the vector DOSINI 
COOCCI] if the diskette-boot was successfully completed during the 
Power-up initialization. Gee Section 10 for details of the 
diskette-boot process. 


H. Same as power-up steps 19 and 20. 


Note that the initialization procedures and main entries for all 
software entities are executed at every system reset as well as 
at power up (see steps 14, 17, 18 20, F and G@}. If the 
user~supplied initialization/startup code must behave differently 
in response to system reset than it does to power-up, then the 
warmstart flag WARMST COO08] should be interrogated: WARMST = © 
means power-up entry, else system reset entry. 
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8 FLOATING POINT ARITHMETIC PACKAGE 


This section describes the BCD floating point (FP) package that 
is resident in the OS ROM in both the models 400 and 800. 


The floating point package maintains numbers internally as 46-byte 
quantities: a S-byte (10 BCD digit)? mantissa with a i-byte 
exponent. BCD internal representation was chosen so that decimal 
division would not lead to the rounding errors typically found in 
binary representation implementations. 


The package provides the following operations: 


ASCII to FP conversion. 

FP to ASCII conversion. 

Integer to FP conversion. 

FP to integer conversion. 

FP add, subtract, multiply, and divide. 

FP logarithm, exponentiation, and polynomial evaluation. 
FP zero, load, store, and move. 


A floating point operation is performed by calling one of the 
provided routines (each at a fixed address in ROM) after having 
set one or more floating point pseudo registers in RAM. The 
result of the desired operation will also involve floating point 
pseudo registers. The primary pseudo registers are described 
below and their addresses given within the square brackets: 
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FRO £€COD4] é-byte internal form of FP number. 


FR1 COOEG) é~-byte internal form of FP number. 
FLPTR COGFC] = 2@-byte pointer (lo, hid to a FP. 
. number. 
INBUFF COOFS3] = 2-byte pointer (lo,hi}d to an ASCII text 
buffer. 
CIX €COF2] = i-byte index, used as offset to buffer 
pointed to by INBUFF. . 
 LBUFF €OS80] = result buffer for the FASC routine. 


FUNCTIONS/CALLING SEQUENCES 
Descriptions of these floating point routines assume that 
a pseudo register is not altered by a given routine. The 


numbers in square brackets E€CxxxxJ are the ROM addresses of the 
routines. 


ASCII to Floating Point Conversion (AFP?) 


Function: This routine takes an ASCII string as input and 
produces a floating point number in internal form. 


Calling sequence: 


INBUFF = pointer to buffer containing the ASCII 
representation of the number. 


CIX = the buffer offset to the first byte of the ASCII 
number. 

JSR AFP CDSC0] 

BCS first byte of ASCII number is invalid 

FRO = floating point number. 

CIX = the buffer offset to the first byte after the ASCII 


number. 


Algorithm: The routine takes bytes from the buffer until it 
encounters a byte that cannot be part of the number. The bytes 
scanned to that point are then converted to a floating point 
number. If the first byte encountered is invalid, the carry bit 
is set as a flag. 


Floating Point to ASCII Conversion (FASC) 


Function: This routine converts a floating point number from 
internal form to its ASCII representation. 
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Calling sequence: 
FRO = floating point number. 
JSR FASC CD8E4] 
INBUFF = pointer to the first byte of the ASCII number. 
The last byte of the ASCII representation has the most 
significant bit (sign bit)? seti no EOL follows. 
Algorithm: The routine converts the number from its internal 
floating point representation to a printable form (ATASCII). The 


pointer INBUFF will point to part of LBUFF, where the result is 
stored. 


Integer to Floating Point Conversion (IFP>} 


Function: This routine converts a 2-byte unsigned integer (0 to 
65535) to floating point internal representation. 


Calling sequence: 


FRO = integer (FRO+O = LSB, FRO+1 = MSB}. 
JSR IFP CD9AAI 
FRO = floating point representation of integer. 


Floating Point to Integer Conversion (FPI} 


Function: This routine converts a positive floating point number 
from its internal representation to the nearest 2-byte integer. 


Calling sequence: 


FRO = floating point number. 
JSR FPI CD9D2] 
BCS FP number is negative or >= 65535. 5 


FRO = 2-byte integer (FRO+O = LSB, FRO+i = MSB>. 


Algorithm: The routine performs true rounding, not truncation, 
during the conversion process. 
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Floating Point Addition (FADD) 


Function: This routine adds two floating point numbers and checks 
the result for out-of-range. 


Calling sequence: 


FRO = floating point number. 

FRi = floating point number. 

JSR FADD £DBA&6] 

BCS out-of-range result. 


FRO = result of FRO + FRI. 
FR1 is altered. 
Floating Point Subtraction (FSUB}) 


Function: This routine subtracts two floating point numbers and 
checks the result for out-of-range. 


Calling sequence: 


FRO = floating point minuend. 
FRi = floating point subtrahend. 
JSR FSUB £DA60] 

BCS out~-of-range rasulf€. 
FRO result of FRO — FR1. 


FR1 is altered. 


Floating Point Multiplication (FMUL) 


Function: This routine multiplies two floating point numbers and 
checks the result for out-of-range. 


Calling sequence: 


FRO = floating point multiplier. 
FRi = floating point multiplicand. 
JSR FMUL CDBADBI 

BCS out-of-range result. 


FRO = result of FRO # FR1. 
FRi is altered. 
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Floating Point Bivision (FDIV) 


Function: This routine divides two floating point numbers and 
checks for division by zero and for result out-of-range. 


Calling sequence: 


FRO = floating point dividend. 

FR1 = floating point divisor. 

JSR FDIV CDB2B] 

BCS out-of-range result or divisor is zero. 


FRO = result of FRO / FRI. 
FRi is altered. 


Floating Point Logarithms (LOG and LOGIC) 


Function: These routines take the natural or base 10 logarithms 
of a floating point number. 


Calling sequence: 


FRO = floating point number. 


JSR LOG CDECD] for natural logarithm 
or 

JSR LOGIO CDEDI] for base 10 logarithm 

BCS negative number or overflow. 


FRO = floating point logarithm. 
FRI is altered. 


Algorithm: Both logarithms are first computed as base 10 
logarithms using a 10 term polynomial approximationi the natural 
logarithm is computed by dividing the base 10 result by the 
constant LOGIGO(e). 


The logarithm of a number Z is computed as follows: 


Fo # (10 ## Y} = Z where i <= F < 10 (normalization). 
i= LOGIOCF) by 10 term polynomial approximation. 
LOGiO(Z) = Y +L. LOG(Z) = LOGIO(Z) / LOGCIOCe?. 


NOTE: This routine does not return an error if the number input 
is zero; the LOGIO result in this case is approximately ~-129. 5, 
which is not useful. 
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Floating Point Exponentiation (EXP and EXP10) 
Function: This routine exponentiates. 
Calling sequence: 


FRO = floating point exponent (2). 


JSR EXP CBBCOIJ for e ## Z 

or 
JSR EXP10 C€DBDCC] for 10 ## Z 
BCS overflow. 


FRO = floating point result. 
FRI is altered. 


Algorithm: Both exponentials are computed internally as base 10, 
with the base e exponential using the identity: 
e## X = 10 ## ( X # LOGIO(e) >. 


The base 10 exponential is evaluated in two parts using the identity: 


10 ##% X = 10 ## (I + Fd = (10 #%# I} *# (10 ## F} -- where I is the 
integer portion of X and F is the fraction. 


The term 10 ## F is evaluated using a polynomial approximation, 
and 10 ## I is a straightforward modification to the floating 
point exponent. 


Floating Point Polynomial Evaluation (PLYEVL> 


Function: This routine performs an n degree polynomial 
evaluation. 


Calling sequence: 


X.Y = pointer (X = LSB) to list of FP coefficients (ACi)> 
ordered from high order to low order (six bytes per 
coefficient}. 

A = number of coefficients in list. 

FRO = floating point independent variable (Z}. 


JSR PLYEVL C€CDDB40) 

BCS overflow or other error. 

FRO = result of Al(n)#Z#4¢#n + ACn—L)#Z#4#nN—-1 2... + ACLI#Z + 
ACO). 


FRI is altered. 


Algorithm: The polynomial P(Z) = SUM(i=O to n>) (ACid#Z##i) is 
computed using the standard method shown below: 


P(Z) = (1... CACMD#Z + ACn-190#Z + 22. + ACL 3#Z + ACO} 
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Clear FRO (ZFRO} 


Function: This routine sets the contents of pseudo register FRO 
to all zeros. 


Calling sequence: 
JSR ZFRO CDA44] 


FRO = zero. 


Clear Page Zero Floating Point Number (ZFi> 


Function: This routine sets the contents of a zero-page floating 
point number to all zeroes. 


Calling sequence: 


X = Zero-~page address of FP number to clear. 
JSR ZFi £CDA4&é] 
Zero-page FP number(X) = zero. 


Load Floating Point Number to FRO (FLDOR and FLDOP) 


Function: These routines load pseudo register FRO with the 
floating point number specified by the calling sequence. 


Calling sequences: 
X,¥ = pointer (X = LSB) to FP number. 
JSR FLDOR (DD89] 
or 
FLPTR = pointer to FP number. 
JSR FLDOP EDDS8D] 


FRO = floating point number (in either case). 
FLPTR = pointer to FP number (in either case). 
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Load Floating Point Number to FRi (FLDIR and FLDIP} 


Function: These routines load pseudo register FRI with the 
floating point number specified by the calling sequence. 


Calling sequences: 


As in prior description, except the result goes to FRI 
instead of FRO. FLDIR (CDD98] and FLDIP CDD9CY. 


Store Floating Point Number From FRO (FSTOR and FSTGP) 


Function: These routines store the contents of pseudo register 
FRO to the address specified by the calling sequence: 


Calling sequence: 
As in prior descriptions, except the floating point number 


is stored from FRO rather than loaded to FRG. FSTOR CDDA7] 
and FSTOP CDDABI. 


Move Floating Point Number From FRO to FRI (FMOVE} 


Function: This routine moves the floating point number in FRO to 
pseudo register FR1. 


Calling sequence: 
JSR FMOVE CDDB4] 


FRL = FRO (FRO remains unchanged). 


RESOURCE UTILIZATION 


The floating point package uses the following RAM locations in 
the course of performing the functions described in this section: 


COD4 through OOFF 
OS7E through OSFF 


All of these locations are available for program coding 
if your program does not call the floating point package. 


OPERATING SYSTEM CO16555 -- Section 8 
128 


IMPLEMENTATION DETAILS 


Floating point numbers are maintained internally as 46-byte 
quantities, with 5S bytes (10 BCD digits)? of mantissa and 1 byte 
of exponent. The mantissa is always normalized such that the 
most significant byte is nonzero (note “byte” and not “BCD 
digit}. 


The most significant bit of the exponent byte provides the sign 
for the mantissai O for positive and 1 for negative. The 
remaining 7 bits of the exponent byte provide the exponent in 
excess 64 notation. The resulting number represents powers of 100 
decimal (not powers of 10). This storage format allows the 
mantissa to hold 10 BCD digits when the value of the exponent is 
an even power of 10, and 9 BCD digits when the value of the 
exponent is an odd power of 10. 


The implied decimal point is always to the immediate right of the 
first byte. An exponent less than 64 indicates a number less than 
1. An exponent equal to or greater than 64 represents a number 
equal to or greater than i. 


Zero is represented by a zero mantissa and a zero exponent. To 
test for a result from any of the standard routines: test either 
the exponent or the first mantissa byte for zero. 


The absolute value of floating point numbers must be greater than 
10##-98, and less than 10##+98, or be equal to zero. There is 
perfect symmetry between positive and negative numbers with the 
exception that negative zero is never generated. 


The precision of all computations is maintained at 9 or 10 
decimal digits. but accuracy is somewhat less for those functions 
involving polynomial approximations (logarithm and 
exponentiation?. Also, the problems inherent in all floating 
point systems are present here: for example: subtracting two very 
nearly equal numbers, adding numbers of disparate magnitude, or 
successions of any operation, will all result in a loss of 
Significant digits. An analysis of the data range and the order 
of evaluation of expressions may be required for some types of 
applications. 


The examples below compare floating point numbers with their 
internal representations, as an aid to understanding storage 
format. All numbers prior to this point have been expressed in 
decimal notation, but these examples will use hexadecimal 
notation. Note that 64 decimal (the excess number of the 
exponent} is 40 when expressed in hexadecimal: 


Number: +0.02 = 2 * 10##-2 = 2 * 100##-1 
Stored: BF 02 CC 00 00 00 (FP exponent = 40 - 1} 


Number: -O.02 = -2 # 10##-2 = -2 *# 100%##-1 
Stored: BF O02 60 00 60 00 (FP exponent = 80 + 40 —- 13 
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Number: +37.0 = 3.7 # 10%#1 = 37 *# 100##0 
Stored: 40 37 00 0C 60O 00 (FP exponent = 40 + GO} 


Number: ~-4. 60312486 # 108811 = ~46.03... # 1LOO##S 
Stored: CS 44 03 O01 24 8&6 (FP exponent = 80 + 40 + 35) 


Number: 0.6 
Stored: OG CO 00 CO 06 00 (special case? 
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9 ADDING NEW DEVICE HANDLERS/PERIPHERALS 

This section describes the interface requirements for a 
nonresident Device Handler that is to be accessed via the Central 
I/O utility (CIO>}. The Serial bus I/0 utility (SIQ) interface is 
defined for those handlers that utilize the Gerial I/0 bus. 

The I/0 subsystem is organized with three levels of software 
between you and your hardware: The CIO, the individual device 
handlers, and the SIO. 


The CIO performs the following functions: 


Logical device name to Device Handler mapping (on OPEN}. 
I/O Control Block (IOCB) maintenance. 

Logical record handling. 

User buffer handling. 


The device handlers are below CIO. They perform the 
following functions: 


Device initialization on power-up and system reset. 
Device-dependent support of OPEN and CLOSE commands. 
Byte-at-a-time data input and output. 
Device-dependent special operations. 
Daviewsiasendent:coanaed support. 

Device data buffer management. 


The SIO is at the bottom level (for Serial I/0 bus peripheral 
handlers}). It performs the following functions: 


Control of all Serial bus I/0, conforming to the bus 
protocol. 


Bus operation retries on errors. 
Return of unified error statuses on error conditions. 
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A separate control structure is used for communication at each 
interface, as follows: 


User/CIo I/O Control Block (IOCB} 
CI0/Handler Zero-~page IOCB (ZIOCB?} 
Handler/SI0O Device Control Block (BCB?} 
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Where: ---- shows a control path. 
#424 shows the data structure required for a path. 


Note the following: 
1. The Keyboard/Display/Screen Editor handlers don’t use 
2. ae aeueiie Handler cannot be called directly from CIO. 
3. The DCB is shown twice in the diagram. 

Figure 9-1 I/O Subsystem Flow Diagram 
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DEVICE TABLE 


The device table is a RAM-resident table that contains the 
single-character device name (e.g. K. D, C, etcd. and the 

handler address for each of the handlers known to CIO. The 

table is initialized to contain entries for the following 

resident handlers: Keyboard (K), Display (S$}, Screen Editor 

(Ed, Cassette (C}, and Printer (P)} at power-up and system reset. To 
install a new handler, some procedure must insert a device table entry 
after the table is initialized. 


The table format is shown below: 


HATABS COSiA] { device name 


qoeee eweee ence conse eons GEtED GIETE CORED SHISD omens WEED SEDED CIEE Conde sete SENEe 


+— one entry 


+ 
‘ 
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a 
+ 
t 
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‘ 
t 
+ 


7 i a a oe eee ee 


Figure 9-2 Device Table Format 


This S6-byte table will hold a maximum of 12 entries, with the 
last 2 bytes being zero. CIO scans the table from the end to 
the beginning (high to low address}; so the entry nearest the 
end of the table will take precedence in case of multiple 
occurrences of a device name.. 


The device name for each entry is a single ATASCII character, and 
the handler address points to the handler‘’s vector table, that 
will be described in the following section. 


CIO/HANDLER INTERFACE 


This section describes the interface between the Central I/0 
utility and the individual device handlers that are represented 
in the Device Table (as described in the preceding section). 
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Calling Mechanism 


Each handler has a vector table as shown below: 


en a ee + 

+ OPEN vector + Clow address? 
a ee + 

+ CLOSE vector + 

oa i a a a ee ee ee + 

+ GETBYTE vector + 

fe eee + 

+ PUTBYTE vector + 

op + 

+ GETSTAT vector + 

, entaatantaataetantententastenteetententmeteeten + 

+ SPECIAL vector + 
ee + 

+ JMP init code + 

+ + (high address} 
ee + 


Figure 9-3 Handler Vector Table 


The device table entry for the handler points to the first 
byte of the vector table. 


The first six entries in the table are vectors (lo, hid that 
contain the address -—- 1 of the handler routine that handles 
the indicated function. The seventh entry is a 6502 JMP 
instruction to the handler initialization routine. CIO uses 
only the addresses contained in this table for handler entry. 
Each user/CIO command translates to one or more calls to one 
of the handler entries defined in the vector table. 


The vector table provides the handler addresses for certain 
fixed functions to be performed to CIO. In addition, operation 
parameters also must be passed for most functions. Parameter 
passing is accomplished using the 6502 A. X. and Y registers 
and an I0CB in page © named ZIOCB C0020]. In general, register 
A is used to pass data, register X contains the index to the 
originating IOCB., and register Y is used to pass status 
information to CIO. The zero-page IOCB, is a copy of the 
originating IOCB; but in the course of processing some 
commands, CIO can alter the buffer address and buffer length 
parameters in ZIOCB, but not in the originating IOCB (see 
Section 5 for information relating to the originating IOCB>. 


See Appendix B for the standard status byte values to be 
returned to CIO in register Y. 
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The following sections describe the CIOQ/handler interface for 
each of the vectors in the handler vector table. 


Handler Initialization 


NOTE: This entry doesn’t appear to have any function for 
nonresident handlers due to a bug in the current OS -- the 
device table is cleared in response to system reset as 
well as power-up. This prevents this entry point from ever 
being called. The rest of this section discusses the 
intended use of this entry point. Conformation would be in 
order to allow compatibility with possible corrected 
versions of the OS in the future. 


The entry was to have been called on all occurrences of 
power-up and system reset; the handler is to perform 
initialization of its hardware and RAM data using a routine 
that assures proper processing of all CIO commands that follow. 


Functions Supported 


This section describes the functions associated with the first 
six vectors from the handler vector table. This section also 
presents a brief, device-independent description of the 
ClO/handler interface and recommended actions for each function 
vector. 


OPEN 


This entry is called in response to an OPEN command to CIO. The 
handler is expected to validate the OPEN parameters and perform 
any required device initialization associated with a device OPEN. 


At handler entry, the following parameters can be of interest: 


X 
Y 


index to originating IOCB. 
$92 (status = function not implemented by handler>. 


HOR 


ICDNOZ £0021] = device number (1-4, for multiple device 
handlers}. 

ICBALZ/ICBAHZ (0024/00251] = address of device/filename 

specification. 


ICAX1Z/ICAX2Z COG2A/002B ] device-specific information. 


The handler attempts to perform the indicated OPEN and 
indicates the status of the operation by the value of the Y 
register. The responsibility for checking for multiple OPENs to 
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the same device or file, where it is illegal. lies with the 
handler. 


CLOSE 


This vector table entry is called in response to a CLOSE command 
to CIO. The handler is expected to release any held resources 
that relate specifically to that device/filename, and for output 
files to: 


1} send any data remaining in handler buffers to the device, 
2} mark the end of file 


3) update any associated directories, allocation maps, etc. 


At handler entry, the following parameters can be of interest: 


X = index fo originating IOCB. 
Y = $92 (status = function not implemented by handler}. 


ICDNOZ £0021] = device number (1-4, for multiple device 
handlers>. 
ICAX1Z/ICAX2Z COOZA/O02BI] = device-specific information. 


The handler attempts to perform the indicated CLOSE and 
indicates the status of the operation by the value of the Y 
register. 


CIO releases the associated IOCB after the handler returns, 
regardless of the operation status value. 


GETBYTE 


This vector table entry is called in response to a GET 
CHARACTERS or GET RECORD command to CIO. The handler is 

expected to return a single byte in the A register, or return an 
error status in the Y register. 


At handler entry, the following parameters can be of interest: 


X 
Y 


index to originating IOCB. 
$92 (status = function not implemented by handler). 


ICDNOZ C0021] = device number (1-4, for multiple device handlers}. 
ICAX1Z/ICAX2Z COO2A/O02BI] = device-specific information. 


The handler will obtain a data byte directly from the device or from a 
handlar-maintained buffer and return to CIO with the byte in the 
A register and the operation status in the Y register. 
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Handlers that do not have short timeouts associated with the 
reading of data (such as the Keyboard and Cassette Handlers), 
must monitor the CBREAKI] key flag BRKAKEY [0011] and return with a 
status of $80 when a CBREAK] condition occurs. See Appendix L, 

ES; and Section i2 for a discussion of CBREAK] key monitoring. 


CIO checks for reads from device/files that have not been opened 
or have been opened for output only: the handler will not be called in 
those cases. 


PUTBYTE 


This entry is called in response to a PUT CHARACTERS or PUT 
RECORD command to CIO. The handler is expected to accept a single 
byte in the A register or return an error status in the Y 
register. 


At handler entry, the following parameters can be of interest: 


X = index to originating IOCB. 
Y = $92 (status = function not implemented by handler}. 
A = data byte. 


ICDNOZ £0021] = device number (1-4, for multiple device 
handlers). 
ICAX1Z/ICAX2Z COO2A/OC2B] = device-specific information. 


The handler sends the data byte directly to the device, or to a 
handler-maintained buffer, and returns to CIO with the operation 
status in the Y register. If a handler-maintained buffer fills, 
the handler will send the buffered data to the device before 
returning to CIO. 


CIO checks for WRITEs to device/files that have not been opened, 
or have been opened for input only. The handler will not be called in 
those cases. 


Now that the normal operation of PUTBYTE has been defined, a 
special case must be added. Any handler that will operate within 
the environment of the ATARI SK BASIC language interpreter has a 
different set of rules. Because BASIC can call the handler 
PUTBYTE entry directly. without going through CIO, the zero-page 
IOCB (ZIOCB) can or may not have a relation to the PUTBYTE call. 
Therefore, the handler must use the outer level IOCB to obtain 
any information that would normally be obtained from ZIOCB. Note 
also that the OPEN protection normally provided by CIO is 
bypassed (i.e. PUTBYTE to a non-OPEN device/file and PUTBYTE to a 
read-only OPEN?>. 
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GETSTAT 


This entry is called in response to a GET STATUS command to CIO. 
The handler is expected to return four bytes of status to memory 
or return an error status in the Y register. 


At handler entry. the following parameters can be of interest: 


X = index to originating IOCB. Y = $92 (status = function not 
implemented by handler}. 


ICDNOZ £0021] = device number (1-4. for multiple device handlers). 
ICBALZ/ICBAHZ [0024/0025] = address of 
device/filename specification. 
ICAX1Z/ICAX2Z 
COOC2ZA/002B] = device-specific information. 


The handler gets device status information from the device 
controller and puts the status bytes in DVSTAT CO2ZEA] through 
DVSTAT+3, and finally returns to CIO with the operation status 
in register Y. 


The IOCB need not be opened nor closed in order for you 

to request CIO to perform a GET STATUS operation: the handler 
must check where there are restrictions. See Section 5 for a 
discussion of the CIO actions involved with a GET STATUS 
operation using both open and closed IOCB’s, and note the impact 
of this operation on the use of the buffer address parameter. 


SPECIAL 


This handler entry is used to support all functions not handled 
by the other entry points, such as diskette file RENAME, display 
DRAW. etc. Specifically, if the IOCB command byte value is 
greater than $O0D, then CIO will use the SPECIAL entry point. The 
handler must interrogate the command byte to determine if the 
requested operation is supported. 


At handler entry, the following parameters can be of interest: 


X 
Y 


index to originating IOCB. 
$92 (status = function not implemented by handler). 


tt 


ICDNOZ £0021] device number (1-4, for multiple device 
handlers?. 

ICCOMZ £0022] = command byte. 

ICBALZ/ICBALH (0024/0025) buffer address. 
ICBLLZ/ICBLHZ (0028/0029) buffer length. 


ICAX1Z/ICAX2Z COO2A/GCO02B I device-specific information. 
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The handler will perform the indicated operation, if possible, 
and return to CIO with the operation status in register Y. 


The IOCB need not be opened nor closed in order for you 

to request CIO to perform a SPECIAL operation; the handler 
must check where there are restrictions. See Section 5S for a 
discussion of the CIO actions involved with a SPECIAL 
operation using both open and closed IONCB’s, and note the 
impact of this on the use of the buffer address parameter. 


Error Handling 


Error handling has been simplified somewhat by having CIO handle 
outer level errors and having SIO handle Serial bus errors, 
leaving the handler to process the remaining errors. These 
errors include: 


out~of-range parameters. 
CBREAK] key abort. 
Invalid command. 

Read after end of file. 


The current handlers respond to errors using the following 
guidelines: 


They keep the recovery simple (and therefore predictable and 
repeatable}. 


They Do not interact directly with you for recovery 
instructions. 


They lose as little data as possible. 


They make all attempts to maintain the integrity of file 


oriented device storage -- this involves the initial design 
of the structural elements as well as error recovery 
techniques. 


Resource Allocation 


Nonresident handlers needing code and/or data space in RAM should 
use the techniques listed below, to assure nonconflict with other 
parts of the OS. including other nonresident handlers. 
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Zero-Page RAM 


Zero~page RAM has no spare bytes, and even if there were, there 
is no allocation scheme to support multiple program assignment of 
the spares. Therefore, the nonresident handler must save and 
restore the bytes of zero-page RAM it is going to use. The bytes 
to use must be chosen carefully, according to the following 
criteria: 


The bytes cannot be accessed by an interrupt routine. 
The bytes cannot be accessed by any noninterrupt code 
between the time the handler modifies the bytes and then 


restores the original values. 


A simple save/restore technique would utilize the stack in a 
manner similar to that shown below: 


LDA COLCRS i (for example) 

PHA i SAVE ON STACK. 

LDA COLCRS+1 

PHA 

LBA HPOINT i HANDLER ‘S POINTER. 


STA COLCRS 
LDA HPOINT+1 
STA COLCRS+1 


XXX (COLCRS}, Y i DO YOUR POINTER THING. 
PLA i RESTORE OLD DATA. 

STA COLCRS+1 

PLA 


STA COLCRS 


Note that the Display Handler or Screen Editor should not be 
called before restoring the original value of COLCRS, because 
COLCRS is a variable used by those routines. 


Nonzero-Page RAM 
There is no allocation scheme to support the assignment of 
fixed regions of nonzero-page RAM to any specific process, so the 


handler has three choices: 


1. Make a dynamic allocation at initialization time by 
altering MEMLO (CO2E71. 


nS 


Include the variables with the handler for RAM-resident 
handlers. This still involves altering MEMLO at the time 
the handler is booted. 


3. If the handler replaces one of the resident handlers (by 
removing the resident handler’s entry in the device 
table}, then the new handler can use any RAM that the 
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formerly resident handler would have used. 


Stack Space 


In most cases, there are no restrictions on the use of the stack 
by a handler. However, if the handler plans to push more than a 
couple dozen bytes to the stacki then it should do a stack 
overflow test, and always leave stack space for interrupt 
processing. 


HANDLER/SIO INTERFACE 


This section describes the interface between serial bus device 
handlers and the serial bus I/O utility (SIO). SIO completely 
handles all bus transactions following the device~independent bus 
protocol. SIO is responsible for the following functions: 

Bus data format and timing from computer end. 

Error detection, retries and statuses. 


Bus timeout. 


Transfer of data between the bus and the caller’s buffer. 


Calling Mechanism 


SIO has a single entry point SIOV CE4S9] for all operations. The 
device control block (BCB} CO300] contains all parameters passed 
to SIO. The BCB contains the following bytes: 


DEVICE BUS ID -- BDEVIC £0300] 


The bus ID of the device is set by the handler prior to calling 
SIO (see Appendix I}. 


DEVICE UNIT # —- BUNIT £0301] 


This byte indicates that of n units of a given device type to 
access, and is set by the handler prior to calling SIO. This 
value usually comes from ICDNOZ. SIO accesses the bus device 
whose address is equal to the value of DDEVIC plus BUNIT minus 1 
(the lowest unit number is normally equal to 1}. 


DEVICE COMMAND -- DCOMND [0302] 


The handler sets this byte prior to calling SIO. It will be sent 
to the bus device as part of the command frame. See Appendix I 
for device command byte values. 
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DEVICE STATUS -- DSTATS C0303] 


This byte is bidirectional. The handler will use DSTATS to 
indicate to SIO what to do after the command frame is sent and 
acknowledged. SIO will use it to indicate to the handler the 
status of the requested operation. 


Prior to an SIO call: 


7 0 
on on en en on oe oon oes 
IWERI unused H 
er a en ono on oe 


Where: W,R 
operation. 


is invalid. 


After an SIO call: 


7 0 
+t $$ — 4 — $+ 


H status code i 


tot tp tte tt 
See Appendix C for the possible SIO operation status codes. 
HANDLER BUFFER ADDRESS -- DBUFLO/DBUFHI [0304/0305] 


The handler sets this 2-byte pointer. It indicates the source 
or destination buffer for device data or status information. 


DEVICE TIMEOUT -- DTIMLO £0306] 


The handler sets this byte. It specifies the device timeout time 
in units of 64/60 of a second. For example, a count of 6 
specifies a timeout of 6.4 seconds. 


BUFFER LENGTH/BYTE COUNT -- DBYTLO/DBYTHI £0308/0209] 


The handler sets this 2-byte count for the current 

operation, and indicates the number of data bytes to be 
transferred into or out of the buffer. This parameter is not 
required if the STATUS byte W and R bits are both zero. These 
values indicate that no data transfer is to take place. 


WARNING: There is a bug in SIO that causes incorrect 


actions when the last byte of a buffer is in a memory 
address ending in $FF, such as I3GFF, 42FF, etc. 
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AUXILIARY INFORMATION --— DAUX1/DAUX2 [CO30A/030B] 


The handler sets these 2@-bytes. The SIO includes them in the bus 
command framei they have device-specific meanings. 


Functions Supported 


SIO does not examine the COMMAND byte it sends to the device, 
because all bus transactions are expected to conform to a 
universal protocol. The protocol includes three forms, stated 
below (as seen from the computer): 


Send command frame. 
Send command frame and send data frame. 
Send command frame and receive data frame. 


The values of the W and R bits in the status byte select the 
command form. 


Error Handling 


SIO handles most of the serial bus errors for the handler, 
as indicated below: 


Bus timeout -- SIO provides a uniform command frame and data 
frame ACK byte timeout of 1/60 of a second —- GO / + 1/60. 

The handler specifies the maximum COMPLETE byte timeout 
value in DTIMLO. 


Bus errors -- SIO detects and reports VUART overrun and 
framing errors. The sensing of these errors in any received 
byte will cause the entire associated frame to be considered 
bad. 


Data frame checksum error -~- SIO validates the checksum on 
all received data frames and generates a checksum for all 
transmitted frames. 


Invalid response from device -- In addition to the error 
conditions stated above, SIO checks that the ACK and 
COMPLETE responses are proper (ACK = $41 and COMPLETE = 
$43). ACK stands for acknowledge. 


Bus operation retries -- SIO will attempt one complete command 
retry if the first attempt is not error free, where a complete 
command try consists of up to 14 attempts to send (and 

acknowledge) a command frame, followed by a single attempt to 
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receive the COMPLETE code and possibly a data frame. 


NOTE: There is a bug in the retry logic for data writes, 
such that if the command frame is acknowledged by the 


controller, but the data frame is not acknowledged, then SIO 


will retry indefinitely. 


Unified error status codes -- SIO provides device-independent error 


codes (see Appendix C}. 


SERIAL 1/0 BUS CHARACTERISTICS AND PROTOCOL 


This section describes: 


oO The electrical characteristics of the ATARI 400 
and ATARI 800 Home Computers serial bus 
0 The use of the bus to send bytes of data, 
9 The organization of the bytes as “frames” (records), 
o The overall command sequences that utilize frames 


and response bytes to provide computer/peripheral communication. 


Hardware/Electrical Characteristics 


The ATARI 400 and the ATARI 800 Home Computers 

communicate with peripheral devices over a 19,200 baud 
asynchronous serial port. The serial port consists of a serial 
DATA OUT (transmission) line, a serial DATA IN (receiver? line 
and other miscellaneous control lines. 


Data is transmitted and received as 8 bits of serial data (LSB 
sent first) preceded by a logic zero start bit and succeeded 
by a logic one stop bit. The serial DATA OUT is transmitted as 
positive logic (+4v = one/true/high, Ov = zero/false/low}. The 
serial BATA OUT line always assumes its new state when the 
serial CLOCK OUT line goes high: CLOCK OUT then goes low in 
the center of the DATA OUT bit time. 


An end view of the Gerial bus connector at the computer or 


peripheral is shown below (the cable connectors would of 
course be a mirror image): 
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9 a) o 0 3) 
a a ) o oO Q o 
1 3 3 7 9? 11 #13 
where: 1 = computer CLOCK IN. 
2 = computer CLOCK OUT. 
3 = computer DATA IN. 
4 = GND. 
3 = computer DATA OUT. 
& = GND. 
7 = COMMAND-. 
8 = MOTOR CONTROL. 
9 = PROCEED-. 
10 = +5v/READY. 
11 = computer AUDIO IN. 
t2 = +12v. 
13 = INTERRUPT-. 


Figure 9-4 Serial Bus Connector Pin Descriptions 

CLOCK IN is not used by the present OS and peripherals. This 
line can be used in future synchronous communications schemes. 
CLOCK OUT is the serial bus clock. CLOCK OUT goes high at the 
start of each BATA OUT bit and returns to low in the middle of 
each bit. 

DATA IN is the serial bus data line to the computer. 

Pin 4 GND is the signal/shield ground line. 

DATA OUT is the serial bus data line from the computer. 

Pin & GND is the signal/shield ground line. 


COMMAND~ is normally high and goes low when a command frame is 
being sent from the computer. 


MOTOR CONTROL is the cassette motor control line (high=on, 
low= of f). 


PROCEED~ is not used by the present OS and peripherals; this line 
is pulled high. 


+5v/READY indicates that the computer is turned on and ready. This 
line can also be used as a +5 volt supply of SOma current rating 
for ATARI peripherals only. 


AUDIO IN accepts an audio signal from the cassette. 
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+12V is a +12 volt supply of unknown current raring for ATARI 
peripherals only. 


INTERRUPT- is not used by the present OS and peripherals: this 
line is pulled high. 


There are no pin reassignments made in the Serial bus cable, 


so pin 3, the computer’s DATA IN line, is the peripheral ‘s 
data output lLinei and similarly for pin 5. 


Serial Port Electrical Specifications 


Peripheral input: 


VIiH = 2. Ov min. 

ViL = 6. 4v max. 

Ii = 2Qua. max. @ VIH = 2. Ov 
Tit = Sua. max. @ VIL = . 4v 


Peripheral output (open collector bipolar}: 


VOL = 0. 4v max. @ 1.4 ma. 
= 4.5v min. with external 1L100Kohm pull-up. 


Vec/READY input: 
2.0v min. @ I1iH = ima. max. 


Vit = 0. 4v max. 
t goes to logic zero when open. 


Bus Commands 
The bus protocol specifies that all commands must originate from the 
computer, and that peripherals will present data on the bus only when 
commanded to. Every bus operation will qo to completion before 
another bus operation is initiated (no overlap). An error detected at 
any point in the command sequence will abort the entire sequence. 
A bus operation consists of the following elements: 

Command frame from the computer. 

Acknowledgement (ACK) from the peripheral. 

Optional data frame to or from the computer. 

Operation complete (COMPLETE) from the peripheral. 
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Command Frame 


The serial bus protocol provides for three types of commands: 1) data 
send, 2) data receive and 3} immediate (no data -- command only?. 
There is a common element in all three types. a command frame 
consisting of five bytes of information sent from the computer 

while the COMMAND- line is held low. The format of the command 

frame is 

shown below: 


Oe me ne cee se a ee a ae + 
i device ID H 
Se ce mn ee ee es ce + 
H command H 
a ea ee se + 
it auxiliary #1 H 
me en ec ce sc + 
i auxiliary #2 i 
me ca ee ce ee ee + 
i checksum H 
ee ee a a ee + 


Figure 9-5 Serial Bus Command Frame Format 


The device ID specifies that of the serial bus devices is being 
addressed (see Appendix I for a list of device IDs}. 


The command byte contains a device-dependent command (see 
Appendix I for a list of device commands}. 


The auxiliary bytes contain more device-dependent information. 
The checksum byte contains the arithmetic sum of the first four 
bytes (with the carry added back after every addition}. 

Command Frame Acknowledge 
The peripheral being addressed would normally respond to a 
command frame by sending an ACK byte ($41) to the computer; if 


there is a problem with the command frame, the peripheral should 
not respond. 


Bata Frame 
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Following the command frame (and ACK?) can be an optional data 
frame that is formatted as shown below: 


ae a a a cn ee ae en ne ee ne te a 
i : 
t t 
g a 
H data { 
= = 
i bytes H 
t t 
f t 
ee + 
H checksum H 
mh me a ee a ee a ee + 


This data frame can originate at the computer or at the device 
controller, depending upon the command. Current device 
controllers expect fixed-length data frames as does the computer, 
where the data frame length is a fixed function of the device 
type and command. 


The checksum value in the data frame is the arithmetic sum of all 
of the frame data preceding the checksum with the carry from 
each addition being added back (the same as for the command 
frame}. 


In the case of the computer sending a data frame to a peripheral, 
the peripheral is expected to send an ACK if the data frame is 
acceptable, and send a NAK ($4E), or do nothing if the data frame 
is unacceptable. See the first flowchart in Section 9. 


Operation Complete 


A peripheral is also expected to send an operation-COMPLETE byte 
($43) at the time the commanded operation is complete. The 
location of this byte in the command sequence for each command 
type is shown in the timing diagrams in Section 9. If the 
operation cannot go to normal, error-free completion, the 
peripheral should respond with an ERROR byte ($45) instead of 
COMPLETE. 
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Bus Timing 


This section provides timing diagrams for the three types of 
command sequences: data send, data receive, and immediate. 
DATA SEND sequence: 
er cde sms cae sos ee cats cots ts ste ese ses en snes ste sm Sete sts see sues sm sine stewie ene snes ste sims ete ses sete cms em esse 
COMMAND— i H 
ta + 
+—-——-—— + $——— ff f+ 
DATA OUT i emnd i i data |! 
=Se+€r ane +----<~ (fers TPaMNe, eH Se seo See sSs> 
+—+ See +—+ 
DATA IN i of i ot i of 
eee ba et tf font te 
ACK ACK CMPL 
it if i ot H ‘ it H 
tO ti t2 t3 t4 tS 
DATA RECEIVE sequence: 
—r fe ese cree rem em snr ae ents eens seen Snes seme evn sen sete sat se See ante sh ete Sam Sts ene ee cnt sate sees Steno se snes ene sees enue 
COMMAND—- i ‘ 
tae + 
S oatetetenteatae + 
DATA OUT i cmnd [ 
Se=—Ptrane Persea sSS SSeS SSS eee aS 
+—+ t+ tee ff f+ 
DATA IN i of it it data ‘ 
ca se cae ee cn ee se se ee + te-—-f/f/-—-+ +--+ frame me ee en ee oe 
ACK CMPL. 
it ff ¢ ¢ H 
tO ti t2 tS 
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IMMEDIATE sequence: 


———+ 
COMMAND— H 
Ca cane cae opens eseey wen eu 
sdf ao wre cos seas ire 
DATA OUT i eomnd 
~~-—+frame 
DATA IN 


tO 


Figure 9-6 Serial Bus 


ta sane we ee crn me see ene sss cre es stm est ns ese sti st tse este sist ste sme sete erm Sn sms iste come eee en 
—— 
—+ 
: 
wp me ee ce ce cme ne ee st tS Se te me Ae ue spe Ost Cnn Ants Mme cans ey sey cecum cess ne eet ee 
+—+ +—+ 
—— ee 
ACK CMPL 
ti t2 tS 


Timing Diagram 


The computer generates a delay (tO) between the lowering of COMMAND- 


and the transmission of 


computer tO (min} 
computer tO (max} 


peripheral tO (min?) 
peripheral tO (max)? 


the first byte of the command frame. 


750 microsec. 
1600 microsec. 


7? 


7? 


The computer generates a delay (t1) between the transmission of 
the last bit of the command frame and the raising of the COMMAND- 


line. 


computer ti (min 
computer ti (max) 


peripheral t¢1 (min) 
peripheral ¢1 (max) 


650 microsec. 
950 microsec. 


?? 
7? 


The peripheral generates a delay (t2) between the raising of 


COMMAND—- and the transmi 


computer t2 (min) = 
computer t2 (max) = 


peripheral te (min) 
peripheral t2 (max) 


ssion of the ACK byte by the peripheral. 


O microsec. 
16 msec. 


= ?? 
= ?? 
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The computer generates a delay (t3) between the receipt of the 
last bit of the ACK byte and the transmission of the first bit of 
the data frame by the computer. . 


1000 microsec. 
1800 microsec. 


computer €3 (min? 
computer t3 (max? 


peripheral ¢3 (min?) 
peripheral t3 (max) 


oS ee | 


dood 


The peripheral generates a delay (t4) between the transmission of 
the last bit of the data frame and the receipt of the first bit 
of the ACK byte by the computer. 


850 microsec. 
16 msec. 


computer £4 (min) 
computer £4 (max> 


peripheral t4 (min? 
peripheral t4 (max) 


i 
4) +} 
J 


The Peripheral generates a delay (t5) between the the receipt of 
the last bit of the ACK byte and the first bit of the COMPLETE 
byte by the computer. 


250 microsec. 
255 sec. Chandler-dependent} 


computer €5 (mind 
computer ¢5 (max>} 


7? 
N/A 


peripheral t5 (min} 
peripheral tS (max) 


HANDLER ENVIRONMENT 


Nonresident handlers can be installed in at least three different 
manners: 


1. As booted software from diskette or cassette. 

2. Resident in a cartridge (A or B). 

3. Downloaded from a serial bus device. 
This section will discuss the basic mechanisms for handler 
installation for these environments. In order to fully utilize the 


information in this section, you must have read and understood the 
following sections: 


Program environments ........ . . Seetion 3 
RAM region... ......... . . . Section 4 
Memory dynamics. . . - oe ew ew ew lel) 6B etion 4 
System initialization. ae . Section 7 
Adding new device handlers/peripherals . Section F 
Program environment and initialization . Section 10 
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Bootable Handler 


The diskette- or cassette-booted software will insert the 
handler‘’s vector table pointer and name to the device table 
whenever the booted software’s initialization entry point is 
entered (on power-up and system reset). Remember that both 
power-up and system reset clear the device table of all but the 
resident handler entries. 


Cartridge Resident Handler 


The cartridge software will insert the handler‘’s vector table 
pointer and name to the device table whenever the cartridge’s 
initialization entry point is entered (on power-up and 

system reset). Remember that both power-up and system reset 
clear the device table of all but the resident handler entries; 
therefore the device table must be reestablished by the 
handler-initialization procedure upon every entry. 


FLOWCHARTS 


The following pages contain process flowcharts showing the SIO 
and peripheral actions for the Serial bus command forms. 
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PERIPHERAL’S COMMAND FRAME PROCESSING 


WAIT FOR 
HIGH TO LOW 
TRANSITION 
ON COMMAND- 


GET NEXT 5 
BYTES ON 
THE BUS 


WAIT FOR 
COMMAND- 
TO GO HIGH 


COMMAND? 
VALID 
AUX DATA 
YES 
SEND ACK 
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DATA FRAME TO PERIPHERAL 


SETUP TO 
READ DATA 
FRAME 


TIMEOUT 


GET N BYTES 
FROM BUS 


SEND ACK 


ATTEMPT TO 
PERFORM 
INDICATED 

OPERATION 


OPERATION 
OK? 
YES 
SEND 
COMPLETE 
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DATA FRAME TO COMPUTER 


ATTEMPT TO 
PERFORM 
INDICATED 

OPERATION 


OPERATION 
OK? 
SEND 

COMPLETE 


SEND DATA 


IMMEDIATE 


ATTEMPT TO 
PERFORM 
INDICATED 

OPERATION 


OPERATION 
OK? 
SEND 
COMPLETE 
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10 PROGRAM ENVIRONMENT AND INITIALIZATION 


This section discusses possible alternative software environments 
using OS Configurations. Environments other than those discussed 
here are also possible. A thorough understanding of the power-up 
and system reset processes (see Section 7} will be necessary to 
evaluate all alternative environments. 


CARTRIDGE 


Most games (and some language processors) are supported via the 
cartridge environment. The cartridge resident software is in 
control of the system, sometimes using the OS and sometimes not. 
A cartridge can specify whether the diskette is to be booted at 
power-up time, whether the cartridge is to provide the 
controlling software, or whether the cartridge is a special 
diagnostic cartridge. These options are specified by bits in the 
cartridge header, as shown below: 


$e + 
H cartridge H BFFA (9FFA for cartridge B) 
+— —+ 
i start address i 
Spe ee + 
H 00 H 
. ecaataateatentententententententententenententan + 
i option byte t 
a ee ee + 
H cartridge H 
+— —+ 
it init address | BFFF (9FFF for cartridge B) 
hen a + 


Figure 10-1 Cartridge Header Format 


The byte of "OO" is used to allow the OS to determine when a 
cartridge is inserted; locations BFFC and 9FFC will not read zero 
when there is neither RAM at those locations nor a cartridge 
inserted. RAM is differentiated from a cartridge by its ability 
to be altered. 
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The option byte has the following option bits: 


bit O = © then do not boot the diskette. 
1, then boot the diskette. 


Bit 2= 0, then init but do not start the cartridge. 
1, then init and start the cartridge. 
bit 7 = G, then cartridge is not a diagnostic cartridge. 


1, then cartridge is a diagnostic cartridge and control 
will be given to the cartridge before any of the OS 
is initialized (JMP (BFFE}>. 


The cartridge init address specifies the location to which the OS will 
JSR during all power-up and system reset operations. As a minimum, 
this vector should point to an RTS instruction. 


The cartridge start address specifies the location to which the OS 
will JMP during all power-up and system reset operations, if 

bit 1 of the option byte is = 1. The application should examine 
the variable WARMST [£0008] if system reset action is to be 
different than power-up (WARMST will be zero on power-up and 
nonzero thereafter). 


Cartridge Without Booted Support Package 


A cartridge that does not specify the diskette-boot option and does 
not support the cassette-boot possibility can use lower memory 
(from 0480 to the address in MEMTOP CO@ES]) in any way it sees 

Fit. 


Cartridge With Booted Support Package 

A cartridge that does specify the diskette-boot option or does 
support the cassette-boot possibility must use some care in its 
use of lower memory. The following regions are defined: 


O480-O46FF is always available to the cartridge. 
MEMLO/MEMTOP region is always available to the cartridge. 


DISKETTE-BOOTED SOFTWARE 


Software can be booted from the disk drive at power-up time in 
response to one of the following conditions: 
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Neither Cartridge A nor B is inserted. 


Cartridge A is inserted and has bit QO of its option byte 
CBFFDI] = 1. 


Cartridge B is inserted and has bit O of its option byte 
COFFD] = 1. 


If any of these conditions are met, the OS will attempt to read 

the boot record from sector #1 of disk drive 1 and then transfer 
control to the software that was read in. The exact sequence of 

operations will be explained later in this section. 


Diskette-Boot File Format 


The kay region of a diskette-boot file is the first six bytes, which 
are formatted as shown below: 


a a a a ee + 
H flags i first byte 
oh ee + 
i # of sectors t 
pen ee ee + 
t memory address |! 
+ —+ 
i to start load H 
OP ne te me ee ee + 
H init H 
+ —+ 
H address i sixth byte 
me ce ce ae ae a + 
H boot i 
H continuation i 
H code i 


Figure 10-2 Diskette-Boot File Format 


The first byte is stored in DFLAGS [0240], but is otherwise 
unused. It should equal zero. 


The second byte contains the number of 128-byte diskette sectors 
to be read as part of the boot process (including the record 
containing this information). This number can range from 1 to 
255, with O meaning 256. 
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The third and fourth bytes contain the address (lo,hi?)? at which to 
start loading the first byte of the file. 


The fifth and sixth bytes contain the address (lo,hid to which the 
booter will transfer control after the boot process is complete 
and whenever the CSYSTEM. RESET] key is pressed. 


The Diskette File Management System (FMS) has extra bytes assigned to 
its boot record, but this is a special case of the generalized 
diskette-boot and is discussed in Section 5. 


Diskette-Boot Process 


If no cartridge is installed. then the diskette will follow these 
steps to boot up: 


1. Read the first diskette record to the cassette buffer [0400]. 
2. Extract information from the first six bytes: 


Save the flags byte to DFLAGS (0240,1]. Save the # of sectors 
to boot to DBSECT €0241,1]. Save the load address to BOOTAD 
CO242,2]. Save the initialization address in BDOSINI (COOOC, 2]. 


3. Move the record just read to the load address specified. 
4. Read the remaining records directly to the load area. 


9. JSR to the load address+6& where a multistage boot process can 
continue. The carry bit indicates the success of this 
operation (carry set = error, carry reset = success). 


NOTE: During step 5S, after the initial boot process is 
complete, the booter will transfer control to the seventh byte 
of the first record. The software should continue the boot 
process at this point, if it is a multistage boot. The value 
of MEMLO CO2E7] should point to the first free RAM location 
beyond the software just booted. It should be established by 
the booted software as shown below: 


LDA #END+ 1 i SET UP LSB. 
STA MEMLO 

STA APPMHI 

LDA #END+1/256 i SET UP MSB. 
STA MEMLO+1 

STA APPMHI+1 


If the booted software is to take control of the 
system at the end of the boot operation, the 
vector BOSVEC COOOA] must be set up by the 
application at this time: DOSVEC points to the 
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restart entry for the booted application. If the 
booted software is not to take control, then 
DOSVEC should remain unchanged. 


LDA #RESTRT i; RESTART LSB. 
STA DOSVEC 

LBA #RESTRT/256 

STA DOSVEC +1 


& JSR indirectly through DOSINI for initialization of the 
application; the application will initialize and return. 


NOTE: The OS enters the initialization point on every 
system reset and power-up. Internal initialization can take 
place during system reset and power-up as well. Initialization 


can also be deferred until Step 7 for controlling 
applications. 


7. JMP indirectly through DOSVEC to transfer control to the 
application. 


NOTE: Pressing the CSYSTEM. RESET] key after the application. 
is fully booted will cause steps & and 7 to be repeated. 


Sample Diskette-Bootable Program Listing 


This skeletal program can be booted from the diskette. It retains 
control when it is entered. 


+ THIS IS THE START OF THE PROGRAM FILE. 


PST= $0700 i (OR SOME OTHER LOCATION). 
+= PST i €, ORG). 


i THIS IS THE diskette-boot CONTROL INFORMATION. 


.BYTE 0O i 
. BYTE PND-PST+127/128 i NUMBER OF RECORDS. 
.WORD PST i MEMORY ADDRESS TO START LOAD. 


-WORD PINIT PROGRAM INIT. 
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i THIS IS THE START OF THE BOOT CONTINUATION. 


LDA #PND ; ESTABLISH LOW MEMORY LIMITS. 
STA MEMLO 

STA APPMHI 

LDA #PND/256 

STA MEMLO+1 

STA APPMHI+1 


LDA #RESTRT i ESTABLISH RESTART VECTOR. 
STA BDOSVEC 
LDA #RESTRT/2546 
STA DOSVEC+1 
CLC i SET FLAG FOR SUCCESSFUL BOOT. 
RTS 

i APPLICATION INITIALIZATION ENTRY POINT. 


PINIT RTS i NOTHING TO DO HERE FOR ... 
i... CONTROLLING APPLICATION. 


i THE MAIN BODY OF THE PROGRAM FOLLOWS. 
RESTRT=+# 
i THE MAIN BODY OF THE PROGRAM ENDS HERE. 


PND= * i ‘PND’ = NEXT FREE LOCATION. 
. END 


Figure 10-3 Diskette-Bootable Program Listing Example 


Program to Create Diskette-Boot Files 


This section provides a program that can be used to make bootable 
files on diskettes. The program given is not the only one possible, 
and no claims are made as to its elegance. 


OPERATING SYSTEM CO165S55 -- Section 10 
162 


Shown below is a listing of the program to create diskette-boot files. 


THIS PROGRAM WRITES A SINGLE "FILE" TO THE DISKETTE AND IS 
USED IN CONJUNCTION WITH A PROCEDURE TO MAKE DISKETTE- 
BOOTABLE FILES. THE FOLLOWING TWO SYMBOLS MUST BE EQUATED 


i USING THE MEMORY LIMITS OF THE PROGRAM TO BE COPIED: 


‘PST’ = PROGRAM START ADDRESS (SEE SAMPLE PROGRAM). 
‘PND’ = PROGRAM END ADDRESS (SEE SAMPLE PROGRAM). 
SECSIZ=128 i DISKETTE SECTOR SIZE. 
PST= $0700 
PND= $1324 
FLEN= PND-PST+SECSIZ-1/SECSIZ ; # OF SECTORS IN FILE. 
+= $BO00 i THIS PROGRAM‘’S ORIGIN. 
BOOTB BRK i ##% LOAD APPLICATION ##+# 
i SET UP DEVICE CONTROL BLOCK FOR DISKETTE HANDLER CALL 


LDA #F LEN i # OF SECTORS TO WRITE. 
STA COUNT 


LDA #1 i DISK DRIVE #1. 
STA DUNIT 


LDA € “W i SET UP FOR WRITE WITH CHECK. 
STA DCOMND 


LDA #PST i POINT TO START OF APPLIC. PROG. 
STA DBUFLO 

LDA #PST/256 

STA DBUFHI 


LBA #01 i SET UP STARTING SECTOR # = 0001. 


STA DAUX 1 
LDA #00 
STA BAUX2 
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i NOW WRITE THE FILE ONE SECTOR AT A TIME. 


BOTO1O JSR DSK INV i WRITE ONE SECTOR. 
BMI DERR ; ERROR. 
LDA DBUFLO i INCREMENT MEMORY ADDRESS. 
CLC 


ADC #SECSIZ 
STA DBUFLO 

LDA DBUFHI 

ADC #0 

STA DBUFHI 


INC DAUX1 + INCREMENT SECTOR #. 
BNE BOTO26 
INC DAUX2 


BOTO2ZO DEC COUNT ; MORE SECTORS TO WRITE? 


BNE BOTO1O i YES. 

BRK i STOP WHEN DONE. 
DERR BRK i STOP ON ERROR. 
COUNT #=#+1 3 SECTOR COUNT. 


i THIS IS THE CARTRIDGE HEADER 


+= $BFF9 i "A" CARTRIDGE. 
INIT RTS 

WORD BOOTB 

BYTE 0.4 

WORD INIT 

. ENB 


CASSETTE-BOOTED SOFTWARE 


You can boot software from the cassette as well as from the 
diskette, at power-up. The following requirements must be met in order 
to boot from the cassette: 


o You must be pressing the CSTART] key as power is 
applied to the system. 


2) A cassette tape with a proper boot format file must be 
installed in the cassette drive, and the PLAY button must be 
pressed. 
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o When you are given the audio prompt by the cassette 
handler you must press the CRETURN] key. 


If all of these conditions are met, the OS will read the boot file 
from the cassette and then transfer control to the software that 
was read in. The exact sequence of operations will be explained 
later in this section. 


Cassette-Boot File Format 


The key region of a cassette-boot file is the first six bytes, that 
are formatted as shown below: 


» eentuntantanhantasbemanterteateetenteetenteten + 
» ontantentantantententamtententestanteatententen + 
i # of Records : 
$e + 
i Memory Address ! 
+-— ——+ 
i To Start Load |: 
he ee + 
i Init i 
oe a+ 
i address i 
pe en ee + 


The first byte is not used by the cassette-boot process. 


The second byte contains the number of 128-byte cassette records to 
be read as part of the boot process (including the record 
containing this information). This number can range from 1 to 255, 
with O meaning 256. 


The third and fourth bytes contain the address (lo,hi)d to which the 


booter will transfer control after the boot process is complete and 
whenever the CSYSTEM. RESET] key is pressed. 


Cassette-Boot Process 

The cassette-boot process is described step-by-step for a 
configuration in that no cartridge is installed and no diskettes are 
attached. For the general case see Section 7. 


1. Read the first cassette record to the cassette buffer. 


2. Extract information from the first six bytes: 
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Save the # of records to boot. Save the load address. Save 
the initialization address in CASINI [£0002] 


3. Move the record just read to the load address specified. 
4. Read the remaining records directly to the load area. 


S. JSR to the load address+6& where a multistage boot process 
can continue; the carry bit will indicate the success of 
this operation (carry set=error, carry reset=success). 


6 JSR indirectly through CASINI for initialization of the 
application; the application will initialize and return. 


7. JMP indirectly through DOSVEC to transfer control to the 
application. 


Pressing the CSYSTEM. RESET] key after the application is fully booted 
will cause steps & and 7 to be repeated. 


NOTE: After the initial boot process is complete, the booter will 
transfer control to the seventh byte of the first record: at this 
point the software should continue the boot process (if it is a 
multistage boot) and then stop the cassette drive. which due to a 
system bug will still be running, using the following instruction 
sequence: 


LDA #$3C 

STA PACTL [D302] 
The application should then set a value in MEMLO (€0237] that 
points to the first free RAM location beyond the software just 
booted, as shown below: 


LDA #END+1 

STA MEMLO 

STA APPMHI 

LDA #END+1/256 
STA MEMLO+ i 
STA APPMHI+1 


If the booted software is to take control of the system at the end 
of the boot operation, the vector DOSVEC [COCOOA] must be set up by 
the application at this time; DOSVEC points to the restart entry 
for the booted application. If the booted software is not to take 
control, then DOSVEC should remain unchanged. 


LDA #RESTRT i RESTART LSB 
STA DOSVEC 

LDA #RESTRT/256 

STA DOSVEC+1 


NOTE: The initialization point is entered on every system reset 
and power-up; internal initialization can take place here. 
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For controlling applications initialization can also be deferred 
until step 7. 


Sample Cassette-Bootable Program Listing 


Shown below is a skeletal program that can be booted from the 
cassette and that retains control when it is entered. 


+ THIS IS THE START OF THE PROGRAM FILE. 
PST= $0700 i (OR SOME OTHER LOCATION). 
+= PST i (€. ORG). 


i THIS IS THE cassette-boot CONTROL INFORMATION. 


.BYTE 0 i (DOESN‘’T MATTER?>. 

. BYTE PND-PST+127/128 i; NUMBER OF RECORDS. 

.WORD PST i MEMORY ADDRESS TO START LOAD. 
.WORD PINIT i PROGRAM INIT. 


i THIS IS THE START OF THE BOOT CONTINUATION. 


LDA #%3C i STOP THE CASSETTE. 
STA PACTL 


LDA #PND i ESTABLISH LOW MEMORY LIMITS. 
STA MEMLO 

STA APPMHI 

LDA #PND/256 

STA MEMLO+1 

STA APPMHI+1 


LDA #RESTRT i ESTABLISH RESTART VECTOR. 
STA DOSVEC 

LDA #RESTRT/256 

STA DOSVEC+1 


CLC i SET FLAG FOR SUCCESSFUL BOOT. 


i APPLICATION INITIALIZATION ENTRY POINT. 


PINIT RTS i NOTHING TO DO HERE FOR... 
i ... CONTROLLING APPLICATION. 


i THE MAIN BODY OF THE PROGRAM FOLLOWS. 


RESTRT=+ 


i THE MAIN BODY OF THE PROGRAM ENDS HERE. 
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PND= + i ‘PND’ = NEXT FREE LOCATION. 
. ENB 


Figure 10-4 Sample Cassette-Bootable Program 


Program to Create Cassette-Boot Files 


This section provides a program listing that can be used to make 
bootable files on cassette tapes. The program given is not the only 
one possible, and no claims are made as to its elegance. 


Shown below is a listing of the program to create a cassette-boot 
file: 


THIS PROGRAM WRITES A SINGLE FILE TO THE CASSETTE AND IS 
USED IN CONJUNCTION WITH A PROCEDURE TO MAKE CASSETTE- 
BOOTABLE FILES. THE FOLLOWING TWO SYMBOLS MUST BE EQUATED 
USING THE MEMORY LIMITS OF THE PROGRAM TO BE COPIED: 


=e me we me 


; ‘PST’ 
i “PND ‘ 


PROGRAM START ADDRESS (SEE SAMPLE PROGRAM)>. 
PROGRAM END ADDRESS (SEE SAMPLE PROGRAM). 


PST= $0700 
PND= $1324 


FLEN= PND-PST+127/128%128 i ROUND UP TO MULTIPLE OF 128. 
+= $BO00 i THIS PROGRAM’S ORIGIN. 
BOOTB LDX #$10 i USE IOCB #1. 


+ FIRST OPEN THE CASSETTE FILE FOR WRITING. 


LDA #0PEN i SET UP FOR DEVICE “OPEN. " 
STA ICCOM, xX 

LDA #0P NOT i DIRECTION IS “OUTPUT. “ 
STA ICAX1, X 

LDA #$80 i SELECT SHORT IRG. 


STA ICAX2, X 


LDA #CFILE ; SET UP POINTER TO DEVICE NAME. 
STA ICBAL., X 
LDA #CFILE/256 


STA ICBAH, X 
JSR croVv i ATTEMPT TO OPEN FILE. 
BMI CERR i ERROR. 


i NOW WRITE THE ENTIRE FILE AS ONE OPERATION. 
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LDA 
STA 


LDA 
STA 
LDA 
STA 


LBA 
STA 
LDA 
STA 


JSR 
BMI 


#PUTCHR 
ICCOM. X 


#PST 
ICBAL., X 
#PST/256 
ICBAH, X 


#F LEN 
ICBLL, X 
#FLEN/256 
ICBLH, X 


CrIoOVv 
CERR 


SET UP FOR “PUT CHARACTERS. “ 


POINT TO START OF APPLIC. PROG. 


SET UP # OF BYTES TO WRITE. 


WRITE ENTIRE FILE. 
ERROR. 


i NOW CLOSE THE FILE AFTER SUCCESSFUL WRITE. 


LDA 
STA 


JSR 
BMI 


BRK 
BRK 
. BYTE 
IS THE 
$BFF9 
RTS 
. WORD 
. BYTE 


. WORD 
. END 


#CLOSE 
ICCOM, X 


crov 
CERR 


$G- "CR 


CARTRIDGE HEADER 


BOOTB 
0,4 


INIT 


SET UP FOR “CLOSE. “ 
CLOSE THE FILE. 
ERROR. 

STOP WHEN DONE. 
STOP ON ERROR. 


FILE NAME. 


"A" CARTRIDGE. 
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1i ADVANCED TECHNIGUES AND APPLICATION NOTES 


This section presents information to use the capabilities of the OS 
and some of the hardware capabilites that aren’t directly available 
through the OS ,and in fact, can be in direct conflict with parts of 
the OS. 


SOUND GENERATION 


The OS uses the POKEY sound generation capabilities only in the I/0 
subsystem, for cassette FSK tone generation. and for the "noisy 
bus" option in SIO. 


Capabilities 


The hardware provides four independently programmable audio 
channels that are mixed and sent to the television set as part of 
the composite video signal. The POKEY registers shown below are all 
concerned with sound control (as described in the ATARI Home 
Computer Hardware Manual}. 


AUBDCTL [CDB208) Audio control. 

AUDCi f€D201] and AUDF1L £D200] Channel i control. 
AUDC2 f[B203] and AUBDF2 (D202 Channel 2 control. 
AUDCS [D205] and AUDFS [D204] Channel 3 control. 
AUDC4 £€B207] and AUDF4 [D206] Channel 4 control. 


Conflicts With OS 


There are two potential conflicts with the OS involving sound 
generation: 


9) The OS can generate its own sounds and then turn off all sounds 
as part of I[/0 operations to the cassette and the serial bus 
peripherals. 


0 The OS does not turn off sounds when you press CSYSTEM. RESET] or 
CBREAK]). If the sounds are to be turned off under those 
conditions, the controlling program must provide that capability. 
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SCREEN GRAPHICS 


Hardware Capabilities 


The hardware capabilities for screen presentations are quite 
versatile; the OS uses a very small amount of the capability 
provided. The means of extension, however, are non-trivial; and 
making changes to a screen format while still utilizing the 
resident Display Handler will be difficult. Gee the ATARI Home 
Computer Hardware Manual for information regarding screen 
presentations. 


OS Capabilities 


The resident Display Handler arbitrarily supports 8 of the 11 
possible full screen modes (11 of 14 modes if the GTIA chip is used 
in place of the CTIA). The resident Display Handler allows for an 
optional “split-screen” text window of fixed size. The hardware 
allows for many more options than the Display Handler supports, as 
will be seen by reading the ATARI Home Computer Hardware 

Manual. 


Cursor Control 


You can control the Display Handler text and graphics cursors 
directly (see Section S and Appendix L. Bi-4}. 


Color Control 


You can alter the color register assignments that the Display 
Handler makes upon all OPEN commands (see Appendix L B7-8 and 
elsewhere}. Note that every system reset or Display Handler OPEN 
will reset the values back to the system default. 
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Alternate Character Sets 


Two character sets are available in screen text modes 1 and 2. The 
value stored in the data base variable CHBAS [(G2F4] selects the 
character set of interest to you. The default value of $E0O 
provides capital (uppercase) letters, numbers and the punctuation 
characters corresponding to display codes $20 through $5F in 
Appendix E}. The alternate value of $E2 provides lowercase letters 
and the special character graphics set (corresponding to display 
codes $460 through $7F and $00 through $1F in Appendix E?}. 


User-defined character sets can also be obtained for text modes O, 
1, and 2 by providing the character matrix definitions in RAM and 
setting CHBAS to point to those definitions. CHBAS always contains 
the most significant bits of the memory address of the start of the 
character definitions, as shown below: 


CHBAS H MSB ix x Text mode © 


+--+ 
i MSB ix Text modes 1 and 2 
++ 
Figure i1i-i User-Defined Character Set Bit Memory Addresses 


(X indicates an ignored address bit 
assumed to be O. } 
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Each character is defined by an 8 x & bit matrix; the 
character ‘@’ is defined as shown below: 


7 0 

Byte +-+-+—-+—-+-+-+-—4-4 
IOLOlOLOlrolroiaeio! 0 

taba ba tt 
fTOLOLLILiLirioio} 1 
Sea samt steeds state steeds staat eet ooo 
POLL LIOiLiLioios 
Se ste seeds teats seats seat eee see 
TOL LILiOiLiLrioio: 
totem tat tat at 
TOLLiLiIGiiiLlioiot 
Sete teeta ceeds dente steed ete ates soto 
fOFLiLiGiGiGioiGi 
Se Seats steeds Gets seats ates see tents 2 
fOLOLLILiLiLriaios 
Se stat steeds stata ateets ate ete seats 
1O1CiOroioicioiodt 
$$$ 4 — + 4 + 


NV O&O om Ff GD BW 


Figure 11-2 User Defined 8 x 8 Character Matrix Bit Table 


The storage for the character set involves eight consecutive 
bytes for each character with characters ordered consecutively by 
their internal code value (see the discussion in Appendix L 
relating to BSS}. 


Character for 
code #00 

Character for 
code $01 


Character base 
8 bytes 


increasing addresses 


Character for 
code $7E 


Character for 
code $7F 


Figure 11-3 Character Base Diagram 
PLAYER/MISSILE GRAPHICS 
The OS makes no use of the player/missile generation capability 
of the hardware. It can be used independently of the OS with no 


conflict. 
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Hardware Capabilities 


The hardware allows a number of independently moveable screen 
obyects of limited width to be positioned and moved about the 
screen without affecting the “playfield" (bit-mapped graphics or 
character) data. Priority control allows the various obyects to 
have a display precedence in case of conflict (overlap?. 


Conflicts With OS 


You must assure that the player/missile data is 

address-aligned as required by PMBASE [D407]. You also must 

find a suitable free area that the OS guarantees to be free under 
all environments. 


READING GAME CONTROLLERS 


The OS reads the game controllers (shown below} as part of the 
stage 2 VBLANK process (see Appendix L J1-9}): 


Joysticks/triggers 1-4. 

Paddle controllers/triggers 1-8. 
Driving controllers/triggers 1-4. 
Light pen/trigger 


In addition to these controllers, other information can be sensed 
or sent using the PIA chip to that the console connectors are 
interfaced. 


Keyboard Controller Sensing 


Data can be read from an ATARI keyboard controller connected to the 
first port. This program alters registers on a chip called a PIA. 

To set these back to the default values to do further I/0, hit 
CSYSTEM. RESET] or POKE PACTL. 60. If this program is to be loaded from 
diskette, use LOAD, not RUN and wait for the busy light on the disk 
drive to go out. Do not execute the program before this light goes 
out, otherwise the diskette continues to spin. 


1 GRAPHICS © 

> PRINT : PRINT " KEYBOARD CONTROLLER DEMO" 

10 DIM ROW(3), 1$(13), BUTTONS (1> 

30 GOSUB 6000 

40 FOR CNT=1 TO 4 

60 POSITION 2. CNT#2+5: PRINT "CONTROLLER # “i CNT; “: “i 
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70 NEXT CNT 


80 FOR CNT=1 TO 4:GOSUB 7000: POSITION 19. CNT+CNT+5: PRINT BUTTONS; 


>NEXT CNT 

120 GOTO 8O 

6000 REM #* SET UP FOR CONTROLLERS #+# 

6010 PORTA=54014: PORTB=54017: PACTL=54018: PBCTL=54019 

4020 POKE PACTL. 48: POKE PORTA. 255: POKE PACTL, S52: POKE PORTA, 221 

6025 POKE PBCTL, 48: POKEPORTB, 255: POKE PBCTL, 52: POKE PORTB, 221 

6030 ROW(0)}=238: ROW(1)}=221: ROW(2)=187: ROW(3)=119 

6040 I$="" 12345678908" 

6050 RETURN 

7000 REM ## RETURN BUTTONS WITH CHARACTER FOR BUTTON WHICH HAS 
BEEN PRESSED ON CONTROLLER CNT (1-4). ## 

7OOL REM ## NOTE: A i WILL BE RETURNED IF NO CONTROLLER IS 
CONNECTED. ## 

7002 REM ## A SPACE WILL BE RETURNED IF THE CONTROLLER IS 
CONNECTED BUT NO KEY HAS BEEN PRESSED. ++ 

7003 PORT=PORTA: IF CNT>2 THEN PORT=PORTB 

7005 P=1 

7008 PAOD=CNT+CNT~-2 

7010 FOR J=0 TO 3 

7020 POKE PORT, ROW( J) 

7030 FOR I=1 TO 10:NEXT I 

7050 IF PADDLE(PA0+1)2>10 THEN P=J+J+J+2: GOTO 7090 

7060 IF PADDLE(PA0}>10 THEN P=J+J+J+3: GOTO 7090 

7070 IF STRIG(CNT-1)}=0 THEN P=J+J+J+4: GOTO 7090 

7O8O NEXT J 

7090 BUTTONS=I16(P, P> 

7095 RETURN 


Figure 11-4 Reading Data From an ATARI Keyboard Controller 
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The table below shows the variable/register values used for reading a 
keyboard controller from each of the four controller ports. 


Port 1 Port 2 Port 3 Port 4 
Sele eet det tet tee eee ote eee ete on on oon ok oon oe oe Seon oor on oe 
: PORT A $ i i ' H 
idirectioni OF i FO H - H - H 
ibits t i H H ‘ 
S clete Steels sets eet tee Seeds See ete et ee on oe ot or ook oe oe oe ee 
i PORT Bi} i i H H 
idirection! - H a i OF i FO H 
ibits H i H H H 
hm hn a he a a he ae a a ttt a te te he nt 
: Port A { FE. FB, ! EF, DF H i 
i row sel { FB,F?7 ¢{ BF,7F { - i= H 
i ect H H H H H 
th pt a a a a ae ae tt a tae ttt 
i: Port B fi i i FE.FD, | €F. DF, | 
i row se- { = H - i FE.F?7 {| BF. 7F i 
i lect H i H H H 
S sSeeaks slene sheeni atmets. stents sheets steeats stent abe. dee ateeet ateete abeete oben eae anti staat steeta stent ateena. same 
i Column LiPADDL1i !PADDL3 {PADDLS {!PADDL7 |: 
i Sense H H H i i 
hm a a a a nah ha pe te han tn tt an tae tan te tt 
i Column 2!{PADDLO !PADDL2 {PADDL4 !PADDL4 [ 
| Sense H i H H t 
a ha a pe ha a a a a ae he he be tt ba tan pe ta tt 
i Column SiSTRIGO !STRIG1 [{STRIG2 iSTRIGS ;{ 
i Sense H i i H H 
pm a ha a pn hae a pe et a pa a ha het a at te tt 


Figure 11-5 ATARI Keyboard Controller Variable/Register Value 
Table 


Front Panel Connectors as I/0 Ports 


The three pages that follow show how some of the pins in the front 
panel (game controller? connectors can be used as general [/0 pins. 


Hardware Information 


PIA (6520 / 6820} 
Out: TTL levels. i load 
In : TTL levels. i load For more information refer 
to 6520 chip manual. 


ome ques onten tens ouste crummy eum coene ceney 
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Port A Circuit (typical): 


A 220 
6520 W—— sack 


ort a & 7 


Male connector, FRONT view 
csi cena ess Pin 8 = Ground 
Pin 7 = Vcc 8+5v #) 


Port B Circuit (typical): 


+5 Note: SOmA maximum 


total external drain 
6520 lyack on power supply allowed 


ne 


"Trigger" Port Circuit (typical): 


220 
CTIA Trig | wack 
al 001 


Software Information 


6520 PIA: (This also pertains to all of the following: ##) 
Port A control (address D302) 


7 @ 5 4 3 2 1 06 


fofol}ala{a{x]o]o| Write this into this register 
Port A Data/Data direction addres 


ing control 
O = Data Direction is at BGOO 
1 = data is at B3Cco 


Port A data direction (address D3OO) 


7 &@ $ 4 3 2 1 90 


Px [xxix] x, x tx |x | Write this into this register. 


Data direction control 


for Port A 
i = Out 
GO = In 
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Port A data (address DBOOC) 
7 & 5 4 3 2 1 0 


RRR aw een Read or Write this register 


43 2 1 4 3 2 i 
ee | 
Jack 2 Jack 1 
Pin Numbers 


Port B Control (address BGOD) 


ele es eee] se 


6920 PIA: 
Port B Control (address D303) 
7 & $$ 4 3 2 1 6 


fofofil[i]1] x] ofo] write this into this register 


ae B Data/Data direction 
addressing control 
QO = B301 contains data 
direction 


i $D3G01 contains 


Port B data direction (address D3O1} 
7 6&© 5 4 3 2 iif 


Px tx} x]|x{x{ x] x] write this into this register 
Ee mm 


data direction control for Port B 
1 = Out 
O = In 


evens (mene mamas aoqme 26000 quem sane cena 


Port B data (address D301) 


t -@ 7S oA SB SB 


(hc a Fe a a ee 


43 21423 2 1 
~~  S 


Jack 4 J ack 3 
Pin Numbers 


cane G00 auto qnie CONT CERD comme cuts emcee 


Four “Trigger” ports: DOIOQ, DOLL, DOi2e, DOLLS 


7 &© 5 4 3 2 1 +9 


fo[o} o| of o}o|o| x] Read this port 


Trigger Value 
DO10 = Port 1 Pin 6 
DO13 = Port 4 pin 6 
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Other Miscellaneous Software Information 


i}. The OS sets up all PIA ports as inputs during 
initialization. 

2}. The OS usually reads the above once per television frame 
(during 
vertical-blank) into RAM as follows: 


Data Base Name Address Data Pins S 

STICKO 0278 7 6 5 4 3 2 1 =@6 Jack 1, pins 4,3,2, 

rofolololx] x] x] x if 10053, 7 
STICK 0729 Jack 2, Pins 4,3,2,1 
STICK2 0274 Jack 3, Pins 4,3,2,1 
STICKS 0278 Jack 4, Pins 4.3,2,1 
STRIGO 0284 Jack 1, Pin & 

7 6 5 4 3 2 i @ 

STRIGL 0285 |} OO] 0] 0] O| O| O| |vack 2. Pin 6 
STRIG2 0286 Jack 3, Pin & 
STRIGS 0287 Jack 4, Pin 6 
PADDL 1 0270 7 6&6 5 43 2 | 

SERRE Jack 1, Pin 5 
PADDL3 0272 Jack 2, Pin 5 
PADDLS 0274 Jack 3. Pin 5 
PADDL7 0276 Jack 4, Pin 5 
PADDLO 0271 Jack 1, Pin 9 
PADDL2 0273 Jack 2, Pin 9 
PADDL4 0275 Jack 3. Pin 9 
PADDL 6 0277 Jack 4, Pin 9 


Figure 11-6 Using Front Panel Connectors As I/0 Ports: Pin 
Function Tables 


* Pins S and 9 are read through the paddle controller circuitry 
a nominal value of 7 indicates that the pin is high (or floating> 
and a nominal value of 228 indicates that the pin is pulled low. 
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Appendix A -- CIO COMMAND BYTE VALUES 


The following hex values are known to be legitimate CIO commands. 
Most handlers: 


O03 -- OPEN 

O05 -~ GET RECORD 

O07 -~ GET CHARACTERS 
09 -~ PUT RECORD 

OB -- PUT CHARACTERS 
OC -- CLOSE 

OD -- GET STATUS 


Display Handler only: 


5 came ae 5 SS 
12 -~- BRAW 


Diskette File Manager only: 


20 -~ RENAME 
2@il -~ DELETE 
22 ~~ FORMAT 
23 ~~ LOCK 
24 -- UNLOCK 
29 ~~ POINT 
26 -- NOTE 
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Appendix B -- CIO STATUS BYTE VALUES 


Shown below are the known CIO STATUS BYTE values. 


O1 (001) -- OPERATION COMPLETE (NO ERRORS?) 
80 (128) -- CBREAK] KEY ABORT 
81 (129) -- IOCB ALREADY IN USE (OPEN) 


82 (130) -- NON-EXISTENT DEVICE 
83 (131) -- OPENED FOR WRITE ONLY 


84 (132) -- INVALID COMMAND 

85 (133) -- DEVICE OR FILE NOT OPEN 

86 (134} -- INVALID IOCB NUMBER (Y reg only? 

87 (135) -- OPENED FOR READ ONLY 

88 (136) -- END OF FILE 

89 (137) -- TRUNCATED RECORD | 

BA (1383 -- DEVICE TIMEOUT (DOESN’T RESPOND> 

SB (139) -- DEVICE NAK 

BC (140) -—- SERIAL BUS INPUT FRAMING ERROR 

8D (141) -—-— CURSOR out-of-range 

SE (142) -—- SERIAL BUS DATA FRAME OVERRUN ERROR 
8F (143) -- SERIAL BUS DATA FRAME CHECKSUM ERROR 
90 (144) -- DEVICE DONE ERROR 

91 (145) -- BAB SCREEN MODE 

92 (146) -- FUNCTION NOT SUPPORTED BY HANDLER 
93 (147) -- INSUFFICIENT MEMORY FOR SCREEN MODE 
AO (1460) -- BISK DRIVE # ERROR 

Al (1461) -- TOO MANY OPEN DISK FILES 

A2 (162) -—- DISK FULL 

A3 (1463) -- FATAL DISK I70 ERROR 

A4 (164) -- INTERNAL FILE # MISMATCH 


AS (165) -- FILE NAME ERROR 
A& (166) -- POINT DATA LENGTH ERROR 
A7 (1673 -- FILE LOCKED 


AS (168) -—- COMMAND INVALID FOR DISK 
A? (149) --— DIRECTORY FULL (64 FILES) 
AA (176) -- FILE NOT FOUND 
AB (171} -- POINT INVALID 
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Appendix C -- SIO STATUS BYTE VALUES 


Shown below 
01 (001) -- 


BA (138) -- 
8B (139) -- 
8C (140) -- 
BE (142) -- 
6F (143) -- 
90 (144) -- 
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are the known SIO STATUS BYTE hexadecimal values. 
OPERATION COMPLETE (NO ERRORS?) 


DEVICE TIMEOUT (DOESN‘T RESPOND?) 
DEVICE NAK 

SERIAL BUS INPUT FRAMING ERROR 
SERIAL BUS DATA FRAME OVERRUN ERROR 
SERIAL BUS DATA FRAME CHECKSUM ERROR 
DEVICE DONE ERROR 
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Appendix D -— ATASCII CODES 


GMQoaA BHU GTHH SMH B&B ABO 


OSsoCOSaGworsareae 


SGoeunv 3s > sx » NEQ— 


SOonMnhrdDP EF KANE S v1 


BeuAN OM TFWM WO MH DW AD ec «a V il 


060000800008 :000R 
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Appendix E -~- DISPLAY CODES (ATASCII> 


EX 


AS | 


THE INVERSE VIDEO 


CX 
-7F 


X 


A 
CODES 8$-FF SHOW 


OF CODES #9 


8X 


acovyunv ses xns-Ghe 


Pant nneD> EM mM NYC 


Ces Seskeveneaseas | Hcoco0@cdes Oooeg 


BX 
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Appendix F -- KEYBOARD CODES (ATASCII) 


CTRL SHIFT & SHIFT L. 
LOWER 

core) ‘ 20 20 <space> 21 40 @ 35 60 * 
Ol A SF 2i ! 1F 41 A SF 61 
02 B 15 22 " 1E 42 8B 15 62 
03 C 12 23 #*€ 1A 43 ¢ i2 63 
04 BD 3A 24 $4 i8 44 D 3A 64 
05 = 2A 25 % iD 45 E 2A 65 
04 F 38 2h & 1B 44 F 38 56 
07 G 3D 27 33 47 CG 3B 4&7 
08 H 39 28 ( 30 48 H 39 68 
09 I OD 29 ) 32 49 I OD 69 
OA J Ol 2A + 07 4Q4 J O1 6A 
OB K 05 2B + 046 4B K 0O5 6B 
oc a 60 2c, 20 4c tL 060 &C 
OD M 235 2D - fo} 4D M 25 6D 
OE Ni 23 ee «x 22 4E N 23 6E 
OF 0 os 2F / 24 4F 0 O68 oF 
10 P CA 30 «66 32 SO P OA 70 
11 Q 2F 31 1 1F Si @ eF 71 
i2 R 28 32 2 1E£ 52 R 28 72 
13 Ss 3E 33 «6=C3 1A 53 S$ SE 73 
14 T 2D 34 4 18 54 T 2B 74 
15 U OB 35 «065 iD 55 U OB 73 
16 Vv 10 36 & iB 56 V 10 7& 
17 W 2E 37 «#67 33 S7 W 2E 77 
is x 16 38 #68 35 5B xX 46 78 
19 Y 2B 39 =«¢ 30 59 Y 2B 79 
iA zZ 17 3A: 02 SA Z 17 7A 
1B <esc> 1C 3B; OD 5B £ 20 7B 
1G — *<up> OE | Oa 36 5c \ O06 7C 
iD “*<down> OF 3D = OF 5D J] 22 7B 
1E “<left> 06 3E > 37 SE * 07 7E 
iF “<right>07 uF ? 26 SF _ O€ TF 
BO-9A FEN 00-14 SF sttab> 2c 
9B <return> and “3 OC,1A AO-FC iN 20-7C 
9C 3 6s<del> 34 FD “2 1E 
PD sCinsert>37 FE “<del> 34 
SE “<Ctab> 2c FF “<insert>37 
Cclear> ::= st or “& 
<return> ::= <return> or s<return> or “<“return> 
Sesc> ::= <ese> or stesc> or ““esc> 
<Sspace> = {space> or s<space> or ““space> 
Where: s as a prefix indicates CSHIFTI. 


“~ as a prefix indicates [CCTRLI. 
/tN as a prefix indicates ATARI key inverse active. 
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Appendix G -- PRINTER CODES (ATASCIT) 


Character set for "normal" mode printing: 


20 <space> 40 @ 60 * 
2i } 41 A 61 a 
a2 " 42 8B 62 »b 
23 #€ 43 C 63 ¢ 
24 % 44 3D 64 d 
25 Z 435 cE 65 e 
26 & 46 F 66 f 
27 ° 47 CG &7 4g 
26 ¢ 48 H 68 +h 
27 } 49 I 69? i 
24 * 4A J GA 
2B + 4B K 6B k 
2C , 4c Lt 6C 1 
2D - 4D -M 6D om 
2E. («jw 4E N 6E on 
2F / 4F 90 6F oO 
30 0 390 «OP 7O p 
3i 6 Si @Q 7i oq 
32 2 S2 R 72 éT 
33 «63 bo 3 73 =O 
34 4 54 T 74 = 8¢ 
35 5S $5 U 73 Ou 
36 «& 36 V 76 4 
37 «067 57 WwW 77 ow 
38 #38 38 =X 78 x 
39 «9 Ss? Y 79 ~~ y 
SA: SA Z 7A 2z 
3B i SB OCC 7B 
nc | OR sc UN 7c Of 
3D = SB i] 7D Oo} 
SE > SE ~ 7. 
SF °°? SF 7F <space> 


Note: The following codes print differently than defined by 
the ATASCII definition. 


00 through iF print blank. 

60 prints ‘ instead of “diamond". 
7B prints {¢ instead of “spade". 

7D prints } instead of “clear". . 
7E prints ~* instead of “backspace”. 
7F prints blank instead of “tab". 
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Character set for “sideways" mode printing: 


40 @ 60 @ 
41 A 61 A 
42 8B 62 8B 
43 C 43 C 
44  »D 64 D 
45 E 65 € 
46 F 66 F 
47 ¢G 47 & 
48 4H 68 4H 
49 I 49? I 
4A J 6A J 
AB K 6B K 
4c Lb 6C Lk 
4D M 64D M 
4E N 6E WN 
4F 0 6F 0 
30 40 20 =P 70 =P 
31 61 S1 = @G 71 @ 
32 2 Se OR 72 =R 
33 «63 33. O«S 73 =«C*SSS 
34 4 34 =és#T 74 =#é+T 
35 =#S 35 CV 735 #2U 
34 & 34 V 74 V 
37 67 37 ~60W 77 ~2OW 
38 8 38 xX 78 xX 
39 «9 39°C 79? 6Y 
SA: SA Z 7A Z 
3B Oi SB fC 7B OCC 
3c 6 U< sc N 7¢ ON 
3D = SD J 7D] 
3E > SE <up> 7E <up> 
aF ? SF <left> 7F <left> 


Note: the following codes print differently than defined by 
the ATASCII definition. 


OO through 2F print blank. 

SE prints “up arrow" instead of 

SF prints “left arrow" instead of 

60 through 7F repeats 40 through SF instead of proper set. 
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Appendix H -—- SCREEN MODE CHARACTERISTICS 


Mode Horiz. Vert. Vert. Colors Data Color Memory 
# Posit. W/O Sp W Sp Value Reg. Reqd. 
(split) (full) 
Oo 40 24 ~~ 2 backgd. BAK 992 992 
OO~-FF PF 2 
- PF 1% 
1 20 24 20 ° backgd. BAK 674 672 


QO-3F PF O 
40-7F PF 1 
SO-BF PF 2 
CO-FF PF 3 


2 20 i2 10 5 backgd. BAK 424 420 
QO-3F PF O 
40-7F PF i 
G0-BF PF 2 
CO-FF PF 3 


BAK 434 432 


BAK 694 696 


m O GI fla Oo 
“Oo 
nN 
hee 


BAK 1174 1176 


& 160 96 BO 2 BAK 2174 2184 


BO Gf © 
mS 
7 
~~ 


7 160 96 80 4 BAK 4190 4200 


8 320 192 160 2 Bii2 8138 


m O We Oo 
“a 
vl 

~m fuer © 


8138 


= 
6 
cr 
% 
NM 


id 80 192 aaa 1 


10 80 192 meee 9 8138 


bQM Oo 
"DB 
x4 
OWN © 
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PF i 
PF 2 
PF 3 
BAK 
BAK 
BAK 
BAK 
PF O 
PF 1 
PF 2 
PF 3 


AMUBGOwMBPWOWONA WN 


11 80 192 = 16 8138 


= 
o 
co 
) 
#5) 


Notes: 


*% Uses color of PF 2, lum of PF 1. 
2 Uses color of BAK, lum of data value ($0-F). 
x Uses color of data value ($0-F), lum of BAK. 


PF x Playfield color register x. 
PM x Player/Missile Graphics color register x. 
BAK ::= Background color register (also known as PF 4). 


The default values for the color registers are shown below: 


BAK = $00 
PFO = $29 
PFi = $CA 
PF2 = $94 
PF3 = $46 
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The form of a color register byte is shown below: 


74645 43¢2i1 0 
fp pnp 

lum i0: 
ee ee oe 


ra) 
o 
~ 
oO 
~4 
+ -- + 


Where: color (hex values) lum 


gray 

light orange 
orange 

red orange 
pink 

purple 
purple-blue 
blue 

blue 

light blue 
turquoise 
green-blue 
green 
yellow-green 
orange-green 
light orange 


minimum luminance 


t 
# 


(increasing 


luminance} 


§ 
‘ 


t 
€ 


maximum luminance 


NOQuP GMM O 


TAMoOAOmMPWVONOUAWNHK O 
i ee 
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Appendix I -- SERIAL BUS ID AND COMMAND SUMMARY 


Serial bus device IDs 
Floppy diskettes DBi-D4 $31-34 


Printer Pi $40 
RS-232-C Ri-R4 $50-53 


Serial bus control codes 


ACK - $41 (’A%) 
NAK ~ $4E (‘'N‘) 
COMPLETE ~ $43 (°C) 
ERR ~ $495 (‘E‘) 


Serial bus command codes 


READ —- $52 (‘R%) Disk 

WRITE -~ $57 ('°W"?) Printer/Disk 
STATUS ~ $53 (°S%) Printer/Disk 
PUT(no check} -~ $50 (‘PP’) Disk 

FORMAT ~ $21 (71%) Disk 

READ ADDRESS -— $54 (°T%) 

READ SPIN - $51 (’Q’%) Disk 

MOTOR ON -— $55 (°U%) Disk 

VERIFY SECTOR - $56 (°V"%) Disk 
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Appendix J -- ROM VECTORS 


The fixed address OS ROM JMP vectors are shown below: at each 
address is a JMP instruction to the indicated routine. 


Name Addr 

DISKIV E450 # 
DSKINV E453 5.4.2 
criov E456 5.2 
SIOV E459 9.3 
SETVBYV E4&Sc 6.7.2 
SYSVBV E4SF &.3 
XITVBV E442 &.3 
SIOINV E46$ i 
SENDEV E4648 
INTINV E44B + 
CIOINV E46E— 3 
BLKBDV E471 3.1.1 
WARMSV E474 7. 
COLDSV E477 7. 
RBLOKV E4&7A # 
CSOPIV E47D # 


* These vectors are for OS 


The fixed address Floating 
addresses are shown below: 
corresponding routines are 


Reference Function 


Diskette Handler initialization 
Diskette Handler entry. 

CIO utility entry. 

SIO utility entry. 

Set System Timers routine. 

Stage 1 VBLANK entry. 

Exit VBLANK entry. 

SIO utility initialization. 

Send enable routine. 

Interrupt Handler initialization. 
CIO utility initialization. 
Blackboard mode entry. 

Warmstart (CSYSTEM. RESETIJ> entry. 
Coldstart (power-up?) entry. 
Cassette-read block entry. 
Cassette-OPEN input entry. 


internal use only. 


Point Package ROM routine entry point 
complete descriptions of the 
provided in Section &. 


AFP DS0C ASCII to FP convert. 

FASC DSES FP to ASCII convert. 

IFP DOAA Integer to FP convert. 
FPI D9D2 FP to integer convert. 
FADD DAGS FP add. 

FSUB DASO FP subtract. 

~FMUL DADB FP multiply 

FDIV DB2S FP divide. 

LOG DECD FP base e logarithm. 
LOG10 DED1 FP base 10 logarithm. 

EXP DDCO FP base e exponentiation. 
EXP10 DBCC FP base 10 exponentiation. 
PLYEVL DD4G6 FP polynomial evaluation. 
ZFRO DA44 Clear FRO. 

ZF1 DA4&S Clear FP number. 

FLDOR DDS? Load FP number. 

FLDOP DDSD Load FP number. 

FLDIR DB?S Load FP number. 

FLDIP DB9C Load FP number. 

FSTOR DDA7 Store FP number. 

FSTOP DDAB Store FP number. 

FMOVE DBDBS Move FP number. 
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The base addresses of the Handler vectors for the resident 
handlers are shouwn below: 


Screen Editor (E>) E400 
Display Handler (S) E410 
Keyboard Handler (K} E420 
Printer Handler (P) E430 
Cassette Handler (C)} E440 


See Section 5 for the format of the entry for each Handler. 


The 6502 Computer interrupt vector values are shown below: 


Function Address Value 


NMI FFFA E7B4 
RESET FFAC E477 
IRG FFFE E6FE 
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Appendix K -—- DEVICE CHARACTERISTICS 


This appendix describes the physical characteristics of the 
devices that interface to the ATARI 400 and ATARI 8CO Home 
Computers. Where applicable, data capacity, data transfer 
rate, storage format, SIO interface, and cabling will be 
detailed. 


KEYBOARD 


The keyboard input rate is limited by the OS keyboard reading 
procedure to be 60 characters per second. The code for each key 

is shown in Table 5-4. The keyboard hardware has no buffering and is 
rate-limited by the debounce algorithm used. 


DISPLAY 


The television screen display generator has many capabilities 
that are not used by the Bisplay Handler (as described in Section 
> and shown in Appendix H}. There are additional display modes, 
object generators, hardware display scrolling, and many other 
features that are described in the ATARI Home Computer 

Hardware Manual. 


Since all display data is stored in RAM, the display data update 
rate is limited primarily by the software routines that generate 
and format the data and access the RAM. The generation of the 
display from the RAM is accomplished by the ANTIC and CTIA or GTIA 
chips using Direct Memory Access (DMA) to access the RAM data. 

The internal storage formats for display data for the various 


modes are detailed in the ATARI Home Computer Hardware 
Manual. 


ATARI 410 PROGRAM RECORDER 
The ATARI 410 Program Recorder has the following characteristics: 
DATA CAPACITY: 
100 characters per C-60 tape (unformatted). 
DATA TRANSFER RATES: 
# 600 Baud (60 characters per second} 
#Note: The OS has the ability to adyust to different tape soeeas 
(447 - 895 Baud}. 
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STORAGE FORMAT: 


Tapes are recorded in 1/4 track stereo format at 1 7/8 inches per 
second. The tape can be recorded in both directions, where tracks 
1 and 2 are side A left and righti and tracks 3 and 4 are side B 
right and left (industry standard). On each side, the left 
channel (1 or 4) is used for audio and the right. channel (2 and 
3) is used for digital information. 


The audio channel is recorded the normal way. The digital channel 
is recorded using the POKEY two-tone mode producing FSK data at 
up to 600 baud. The MARK frequency is S327 Hz and the SPACE 
frequency is 3995 Hz. The transmission of data is asynchronous 
byte serial as seen from the computer; POKEY reads or writes a 
bit serial FSK sequence for each byte, in the following order: 


1 start bit (SPACE> 

data bit O -—+ 

data bit 1 i 

: +~- © = SPACE, 1 = MARK. 
data bit 6 |! 
data bit 7 -+ 

1 stop bit (MARK) 


The only control the computer has over tape motion is motor 
start/stop; and this only if the PLAY button is pressed by the 
user. In order for recording to take place, the user must press 
both the REC and PLAY buttons on the cassette. The computer has 
no way to sense the position of these buttons, nor even if an 
ATARI 410 Program Recorder is cabled to the computer, so the user must 
be careful when using this device. 
S10 INTERFACE 


The cassette device utilizes portions of the serial bus hardware, 
but does not follow any of the protocol as defined in Section 9. 


ATARI 8S26CLTM] 40-COLUMN IMPACT PRINTER 


The ATARI 820 Printer has the following characteristics: 


DATA CAPACITY: 
40 characters per line (normal printing? 
2° characters per line (sideways printing? 
DATA TRANSFER RATES: 
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Bus rate: xx characters per second. 
Print time (burst): xx characters per second. 
Print time (average): xx characters per second. 


STORAGE FORMAT: 


3 7/8 inch wide paper. 
9X7 dot matrix, impact printing. 


Normal format --— 
40 characters per line. 
6 lines per inch (vertical). 
12 characters per inch (horizontal). 


Sideways format -- 
29 characters per Line. 
6& lines per inch (vertical). 
9 characters per inch (horizontal }. 


SIO INTERFACE 
The controller serial bus ID is $40. 
The controller supports the following SIO commands (see Section 5 


for more information regarding the Handler and Section 9 for a 
general discussion of bus commands}: 


GET STATUS 
The computer sends a command frame of the format shown below: 


Device ID = $40. 
Command byte = $53. 


auxiliary 1 = doesn’t matter. 
auxiliary 2 = doesn’t matter. 
Checksum = checksum of bytes above. 


The printer controller responds with a data frame of the format 
shown earlier in this appendix as part of the GET STATUS 
discussion. 


PRINT LINE 


The computer sends a command frame of the format shown below: 


Device IBD = $40. 
Command byte = $57. 
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auxiliary 1 = doesn’t matter. 
auxiliary 2 = $4£ for normal print or $53 for sideways. 
Checksum = checksum of bytes above. 


The computer sends a data frame of the format shown below: 
Leftmost character of line (column 1}. 
Next character of line (column 2). 
Rightmost character of line (column 40 or 29). 
Checksum byte. 
Note that the data frame size is variable. either 41 or 30 bytes 


in length. depending upon the print mode specified in the command 
frame. 


ATARI 810 DISK DRIVE 
The ATARI GiOLTM] Disk Drive has the following characteristics: 


DATA CAPACITY: 


720 sectors of 126 bytes each (Disk Handler format). 
7G? sectors of 125 data bytes each (Disk File Manager format). 


DATA TRANSFER RATES: 


Bus rate: 1920 characters per second. 
Seek time: 5.25 msec. per track + 10 to 210 msec. 
Rotational latency: 104 msec maximum (286 rpm). 


STORAGE FORMAT: 


5 1/4 inch diskette, soft sectored by the controller. 

40 tracks per diskette. 

18 sectors per track. 

128 bytes per sector. 

Controlled by National INS1771-1 formatter/controller chip. 

Sector sequence per track is: 18 i. 3 5S. 7, % 11, 123, 15, 
17, 2, 4 & & 10, 12, 14, 16 


SIO INTERFACE 


The controller serial bus IDs range from $31 (for ‘Di’? to $34 
(for ‘D4’). 
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The controller supports the following SIO commands (see earlier 
in this Appendix for information about the Diskette Handler and 
Section 9 for a general discussion of bus commands}: 


GET STATUS 


> 


The computer sends a command frame of the format shown below: 


Device ID = $31-34. 

Command byte = $53. 

auxiliary 1 = doesn’t matter. 

auxiliary 2 = doesn’t matter. 

Checksum = checksum of bytes above. 


The diskette controller responds with a data frame of the format 
shown earlier in this Appendix as part of the STATUS REQUEST 
discussion. 


PUT SECTOR (WITH VERIFY} 
The computer sends a command frame of the format shown below: 


Device IBD = $31-34 

Command byte = $57. 

auxiliary 1 = low byte of sector number. 
auxiliary 2 = high byte of sector number (1-720}. 
Checksum = checksum of bytes above. 


The computer sends a data frame of the format shown below: 


128 data bytes. 
Checksum byte. 


The diskette controller writes the frame data to the specified 
sector, then reads the sector and compares the content with the 
frame data. The COMPLETE byte value indicates the status of the 
operation. 


PUT SECTOR (NO VERIFY?) 
The computer sends a command frame of the format shown below: 


Device IBD = $31-34 

Command byte = $50. 

auxiliary 1 = low byte of sector number. 
auxiliary 2 = high byte of sector number (1-720}. 
Checksum = checksum of bytes above. 


The computer sends a data frame of the format shown below: 
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128 data bytes. 
Checksum byte. 


The diskette controller writes the frame data to the specified 
sector, then sends a COMPLETE byte value that indicates the 
status of the operation. 


GET SECTOR 


The computer sends a command frame of the format shown below: 


Device ID = $31-34 

Command byte = $52. 

auxiliary 1 = low byte of sector number. 
auxiliary 2 = high byte of sector number (1-720). 
Checksum = checksum of bytes above. 


The diskette controller sends a data frame of the format shown below: 


128 data bytes. 
Checksum byte. 


FORMAT DISKETTE 


The computer sends a command frame of the format shown below: 


Device ID = $31-34 

Command byte = $21. 

auxiliary i = doesn’t matter. 

auxiliary 2 = doesn’t matter. 

Checksum = checksum of bytes above. 


The diskette controller completely formats the diskette (generates 40 
tracks of 18 soft sectors per track with the data portion of each 
sector equal to all zeros) and then reads each sector to verify 

its integrity. A data frame of 128 bytes plus checksum is 

returned in that the sector numbers of all bad sectors (up to a 
maximum of 63 sectors) are contained, followed by two consecutive 
bytes of $FF. If there are no bad sectors on the diskette the first 

2 bytes of the data 
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Appendix L ~- OS DATA BASE VARIABLE FUNCTIONAL DESCRIPTIONS 


CENTRAL DATA BASE DESCRIPTION 


This appendix provides detailed information for those variables 
in the OS data base that can be altered by the user. Remaining 
variables are provided narrative descriptions. Information on the 
variables is presented in a multiple access scheme: Lookup 
tables are referenced to a common set of narratives, that is 
itself ordered by function. 


Variable descriptions are referenced by a label called a variable 
identifier (VIB) number. The label comprises a single letter 
followed by a number. A different letter is assigned for each 
mayor functional area being described, and the numbers are 
assigned sequentially within each functional area. Those 

variables that are not considered to be of interest to any user 
are flagged with an asterisk (#) after their names. The data base 
lookup tables provided are: 


1. Functional grouping -- index to the function narrative and 
descriptions of variables, giving VID and variable name. 


2. Alphabetic list of names -- giving VID of description. 
3. Address ordered list -- giving VID of description. 


Item 1, the functional grouping index, starts on the next page: 
the other two lookup tables are at the end of Appendix L. 
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FUNCTIONAL INDEX TO DATA BASE VARIABLE DESCRIPTIONS 


A. Memory configuration 
Al MEMLO 
A2 MEMTOP 
A3 APPMHI 
A4 RAMTOP 
AS RAMSIZ 


B. Text/graphics screen 


Cursor control 
Bi CRSINH 
B2 ROWCRS, COLCRS 
B3 OLDROW, OLDCOL 
B4 TXTROW, TXTCOL 


Screen margins 
BS LMARGN 
B&é RMARGN 


Color control 
B7 PCOLRO ~- PCOLRS 
BS COLORG — COLOR4 


Text scrolling 
BS SCRFLG# 


Attract mode 
BiG ATRACT 
Bil COLRSH+ 
Bi2 DRAMSK+ 


Tabbing 
BiG TABMAP 


Logical text lines 
Bi4 LOGMAP# 
BiS LOGCOL+# 


Split screen 
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Bié BOTSCR# 


FILL/DRAW function 
Bi7 FILBAT 
Bi8 FILFLG# 
Bi9 NEW SROW+, NEWCOL+ 
B20 HOLD4+ 


Bei ROWINC+#, COLINC# 
B22 DELTAR#, DELTAC# 
B23 COUNTR+# 

B24 ROWAC#, COLAC 
B2S ENDPT+ 


Displaying control characters 


Escape (display following control char) 
B26 ESCFLG# 


Display control characters mode 
B27 DSPFLG 


Bit mapped graphics 
B28 DMASK+ 
B29 SHFAMT+ 


OPERATING SYSTEM CO16555 -- Appendix L 
202 


Internal working variables 


B30 


HOLDi+x 

HOLD2+ 

HOLDS+ 

TMPCHR* 

DSTAT# 

DINDEX 

SAVMSC 

OLDCHR+# 
OLDADR+# 
ADRESS 

MLTTMP /OPNTMP / TOADR+# 
SAVADR /FRMADR+ 
BUFCNT# 
BUFSTR*# 
SWPFLG# 
INSDAT+# 
TMPROW+, TMPCOL+ 
TMPLBT+ 
SUBTMP # 
TINDEX+ 
BITMSK+* 
LINBUF + 

TXTMSC 

TXTOLD+ 
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Internal character code conversion 
BS4 ATACHR 
BSS CHAR*s 


C. Bisk Handler 
Ci BUFADR+ 
C2 DSKTIM+# 


D. Cassette (part in SIO part in Handler? 


Baud rate determination 

Di CBAUDL+*, CBAUBDHs 

D2 TIMFLG+# 

DS TIMER1I#, TIMER2* 

D4 ADDCOR# 

DS TEMPi+x 

DG TEMPS+# 

D7 SAVIOx 


Cassette mode 
DS CASFLGs 


Cassette buffer 
D9 CASBUFs 
DIO BLIMs 
Dii BPTRs 


Internal working variables 
Dli2 FEOF 
Di3 FYYPEs 
D1i4 WMODE+ 
DiS FREQ 


E. Keyboard 


Key reading and debouncing 
El CHi+s 
E2 KEYDEL+* 
ES CH 


OPERATING SYSTEM CO16555 -- Appendix L 
204 


Special functions 


Start/stop 
E4 SSFLAG 


CBREAKI 
ES BRKKEY 


ESHIFTI/CCONTROLI lock 
E& SHFLOK 
E7 HOLDCH+# 


Autorepeat 
ES SRTIMR+s 


Inverse video 
ES INVFLG 


Console switches (CSELECTI, CSTART], and COPTIONI>) 


Printer 
printer-buffer 


Fi PRNBUF# 
F2 PBUFSZ* 
FS PBPNT*# 


Internal working variables 
F4 PTEMPs 
FS PTIMOT+ 


Central I/0 routine (CIO} 
User call parameters 


Gi IOCB 
G2 ICHID 
G3 ICBNO 
G4 IccoM 
GS ICSTA 
G4 ICBAL, ICBAH 
G7 ICPTL, ICPTH 
GB ICBLL. ICBLH 
G? ICAX1, ICAX2 
Gi0 ICSPR 


Device status 
Gili BVSTAT 


device table 
Gi2 HATABS 
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CIO/Handler interface Parameters 


G13 ZIOCB (IOCBAS) 

G14 ICHIDZ 

G15 ICDNOZ 

G16 ICCOMZ 

G17 ICSTAZ 

G18 ICBALZ, ICBALH 

G19 ICPTLZ, ICPTHZ 

G20 ICBLLZ, ICBLHZ | 

Gal ICAX1Z, ICAX2Z 

G22 ICSPRZ (CICIDNO, CIOCHR? 


Internal working variables 
G23 ICCOMT# 
G24 ICIDNO# 
G25 CIOCHR# 


H. Serial I/O routine (SIO) 


User call parameters 


H1 DCB control block 
H2 DDEVIC 
H3 DUNIT 
H4 DCOMND 
HS DSTATS 
H&S DBUFLO, DBUFHI 
H7 DTIMLO 
HE DBYTLO, DBYTHI 
HO DAUX1, BAUX2 


Bus sound control 
H10 SOUNDR 


Serial bus control 


Retry logic 
Hii CRETRY+ 
Hi2 DRETRY+ 


Checksum 
Hi3 CHKSUM+* 
Hi4 CHASNT+# 
H1iS NOCKSM+ 
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Data buffering 
General buffer control 


H1ié BUFRLO#, BUFRHI# 
Hi7 BFENLO+, BFENHI+# 


Command frame output buffer 
H1i8 CDEVIC+# 
Hi9 CCOMND+ 
H20 CAUX1#, CAUX2+ 


Receive/transmit data buffering 
H21 BUFRFL+ 
H22 RECVDN* 
H23 TEMP 
H24 XMTDON# 


SIO timeout 
H2S5S TIMFLG+# 
H26 CDBDTMV1* 
H27 CDTMA1+# 


Internal working variables 
H28 STACKP# 
H29 TSTAT+# 
H30 ERRFLG+ 
H3S1 STATUS+# 
H32 SSKCTL+* 


ATARI controllers 


Joysticks 
Ji STICKO —- STICKS 
J2 STRIGO -— STRIGS 
Paddles 
J3 PADDLO -— PADDL7 
- PTRIG7 


J4 PTRIGO 


Paddle controllers 
JB STICKO - STICKS 
J? STRIGO — STRIGS 


K. Disk file manager 
Ki FMSZPG# 
K2 ZBUFPs 
K3 ZBDRVA+ 
K4 ZSBAe 
KS ERRNO# 
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L. Disk utilities (DOS) 
Li DSKUTL+# 


M. Floating point package 
Mi FRO 
M2 FRE 
M3 FRI 
M4 FR2# 
MS FRX# 
M& EEXP# 
M7 NSIGN+# 
MS ESIGN 
M9? FCHRFLG# 
M10 DIGRT# 
Mil CIX 
Mi2 INBUFF 
Mi3 ZTEMPi+ 
M14 ZTEMP 4s 
M1S ZTEMP3* 
M16 FLPTR 
M17 FPTR2s 
MiG LBPRi+# 
Mi? LBPR2« 
M20 LBUFF 
M21 PLYARG# 
M22 FPSCR/FSCR# 
M23 FPSCRi/FSCR1+* 
M24 DEGFLG/RADFLGs 


N. Power-Up and System Reset 
RAM sizing 
Ni RAMLO#, TRAMSZ* 
N2 TSTBDAT# 


Diskette/cassette-boot 

N3 DOSINI 

N4 CKEY# 

NS CASSBT# 

N& CASINI 

N7 BOOT? 

N8 DFLAGS+* 

N9 DBSECT# 

NiO BOOTADs 


Environmental control 
Nil COLDST 
Ni2 DOSVEC 
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CS RESETI 
Ni3 WARMST 


Interrupts 
Pi CRITIC 
P2 POKMSK 


System Timers 


Real-time clock 
P3 RTCLOK 


System Timer 1 
P4 CDTMV1 
PS CDTMA1L 


System Timer 2 
P& CDTMV2 
P7 CDTMA2 


System Timers 3-5 
PS CDTMV3,. CDTMV4, CDTMVS 
P9 CDIMFS, CDTMF 4, CDTMFS 


RAM-interrupt vectors 


NMI-~interrupt vectors 
P10 VYDSLST 
Pili VVBLKI 
Pi2 VVBLKAD 


IRQ@-interrupt vectors 
Pi3 VIMIRG 
Pi4 VPRCED 
PiS VINTER 
P16 VBREAK 
Pi7 VKEYBD 
Pigs VSERIN 
P19 VSEROR 
P20 VSEROC 
P21 VTIMR1I, VTIMR2, VTIMRA 


Hardware register updates 
P22 SDMCTL 
P23 SDLSTL, SDLSTH 
P24 GPRIOR 
P25 CHACT 
P26 CHBAS 
P27 PCOLR«x, COLOR x 
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Internal working variable 
P28 INTEMP# 


R. User areas 
Ri (unlabeled>} 
R2 USAREA 


This appendix contains descriptions of many of the data base 
variables; descriptions are included for all of the user- 
accessible variables and for some of the “internal” variables as 
well. Those variables that are not considered to be normally of 
interest to any user are flagged with an asterisk (#} after their 
namesi the other variables can be of interest to one or more of 
the following classes of users: 


End user. 

Game developer. 

Applications programmer. 
System utility writer. 
Language processor developer. 
Device Handler Writer. 


oo0o00o00c00 86 


Each variable is specified by its system equate file name 
followed by its address (in hex} and the number of bytes reserved 
in the data base (in decimal), in the following form: 

<name> C<Caddress>, <size>] 
For example: 


MEMLO €GC2E7, 2] 


Note that most word (2 byte) variables are ordered with the least 
significant byte at the lower address. 
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A. MEMORY CONFIGURATION 


See Section 4 for a general discussion of memory dynamics and 
section 7 for details of system initialization. 


Al MEMLO (CO2E7,2] -- User-free memory low address 


MEMLO contains the address of the first location in the free 
memory region. The value is established by the OS during power-up 
and system reset initialization and is never altered by the OS 
thereafter. 


42 MEMTOP CO2ZES, 21 -- User-free memory high address 


MEMTOP contains the address of the first non-useable memory 
location above the free memory region. The value is established 
by the OS during power-up and system reset initialization: and 
then is re-established whenever the display is opened, based upon 
the requirements of the selected graphics mode. 


43 APPMHI COOOE, 2] -- User-free memory screen lower Limit 

APPMHI is a user-controlled variable that contains the address 
within the free memory region below which the Display Handler cannot 
go in setting up a display screen. This variable is 

initialized to zero by the OS at power-up. 

A4 RAMTOP# (C006A,11] -- Display Handler top of RAM address (MSB? 
RAMTOP permanently retains the RAM top address that was contained 

in TRAMSZ (as described in Ni?) for the Display Handler’s use. The 
value is set up as part of Handler initialization. 


AS RAMSIZ (O2E4,1] -- Top of RAM address (MSB only? 


RAMSIZ permanently retains the RAM top address that was contained 
in TRAMSZ (as described in N1). 
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B. TEXT/GRAPHICS SCREEN 


See Section S$ for a discussion of the text and graphics screens 
and their Handlers. 


Cursor Control 


For the text screen and split-screen text window there is a 
visible cursor on the screen which shows the position of the next 
input or output operation. The cursor is represented by inversing 
the video of the character upon which it resides: but the cursor 
can be made invisible, at the user’s option. The graphics screen 
 @always has an invisible cursor. 


The cursor position is sensed by examining data base variables 
and can be moved by altering those same variables: in addition, 
when using the SGcreen Editor, there are cursor movement control 
codes that can be sent as data (as explained in Section 5). 


Bi CRSINH [£02FC,1] -- Cursor display inhibit flag 


When CRSINH is zero, all outputs to the text screen will be 
followed by a visible cursor (inversed character); and when 
CRSINH is nonzero, no visible cursor will be generated. 


CRSINH is set to zero by power-up, the CSYSTEM. RESET] or CBREAK] keys 
or an OPEN command to the Display Handler or Screen Editor. 


Note that altering CRSINH does not cause the visible cursor to 
change states until the next output to the screens if an 
immediate change to the cursor state is desired, without altering 
the screen data, follow the CRSINH change with the output of 
CURSOR UP, CURSOR DOWN, or some other innocuous sequence. 


B2 ROWCRS (0054.1]3 and COLCRS (£0055, 2] -- Current cursor 
position 


ROWCRS and COLCRS define the cursor location (row and column, 
respectively} for the next data element to be read from or 
written to the main screen segment. When in split-screen mode, 
the variables TXTROW and TXTCOL define the cursor for the text 
window at the bottom of the screen as explained in B4 below. 


The row and column numbering start with the value zero, and 
increase in increments of one to the number of rows or columns minus 
1; with the upper left corner of the screen being the origin (0,0). 


ROWCRS is a single-byte variable with a maximum allowable value 
of 191 (screen modes &-11); COLCRS is a 2-byte variable with a 
maximum allowable value of 319 (screen mode 8>. 
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B32 OLDROW COOSA. 1] and OLDCOL (C005B,2] -- Prior cursor position 


OLDROW and OLDCOL are updated from ROWCRS and COLCRS before every 
Operation. The variables are used only for the DRAW and FILL 
operations. 


B4 TXTROW £60290,1] and TXTCOL €0291,2] -- Split-screen text cursor 
position 


TXTROW and TXTCOL define the cursor location (row and column, 
respectively) for the next data element to be read from or 
written to the split-screen text window. 


The row and column numbering start with the value zero, and 
increase in increments of one to 3 and 39, respectively; with the 
upper left corner of the split-screen text window being the origin 
(0,0). . 


Screen Margins 


The text screen and split-screen text window have user-alterable 
left and right margins that define the normal domain of the text 
cursor. 


BS LMARGN (€0052.,1] -- Text column left margin 


LMARGN contains the column number (0-39) of the text screen left 
margin; the text cursor will remain on or to the right of the 
left margin as a result of all operations. unless the cursor 
column variable is directly updated by the user (see B2 and B4 
above}. The default value for LMARGN is 2 and is established upon 
power-up or system reset. 


B6 RMARGN £0053, 1] -- Text column right margin 


RMARGN contains the column number (0-39) of the text screen right 
margin: the text cursor will remain on or to the left of the 
right margin as a result of all operations, unless the cursor 
column variable is directly updated by the user (see B2 and B4 
above}. The default value for RMARGN is 39 and is established 
upon power-up or system reset. 
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Color Control 


As part of the stage 2 VBLANK process (see Section 6), the values of 
nine data base variables are stored in corresponding hardware 

color control registers. The color registers are divided into two 
groups: the player/missile colors and the playfield colors. The 
playfield color registers are utilized by the different screen modes 
as shown in Appendix H. The player/missile color registers are not 
used by the standard OS. 


B7 PCOLRO - PCOLRS (02C0,4] -- Player/missile graphics colors 


Each color variable is stored in the corresponding hardware 
register as shown below: 


PCOLRO C€02CO] COLPMO [D012] 
PCOLR1 (CO2C1] COLPM1 CDO13] 
PCOLR2 (CO02C2] COLPM2 £DO014] 
PCOLR3S C02C3] COLPMS (€DO159] 


Each color variable has the format shown below: 


76343210 


See Appendix H for information regarding the color and luminance 
field values. 


BS COLORO —- COLOR4 £02CS,5] -- Playfield colors 


Each color variable is stored in the corresponding hardware 
register as shown below: 


COLORO (62C4] COLPFO [D016] 
COLOR1 (CO2C5] COLPF1i CDO17] 
COLOR2 (C2C4] COLPF2 [D018] 
COLORS (062C7] COLPFS (CDO19] 

CO2C8] COLBK CDO1AI 


COLOR4 
Each color variable has the format shown below: 


76434321 0 


mp pa pe he 
i color ! lum ¢txi 
Se ee oe on on on oo oe 


See Appendix H for information regarding the color and luminance 


field values. 
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Text Scrolling 


The text screen or split-screen text window “scrolls" upward 
whenever one of the two conditions shown below occurs: 


's) A text line at the bottom row of the screen extends past the 
Tight margin. 


o A text line at the bottom row of the screen is terminated by 
an EOL. 


Scrolling has the effect of removing the entire logical line that 
starts at the top of the screen and then moving all subsequent 
lines upward to fill in the void. The cursor will also move 
upward if the logical line deleted exceeds one physical line. 


B9 SCRFLG# CO2BB,1] -- Scroll flag 


SCRFLG is a working variable that counts the number of physical 
lines minus 1 that were deleted from the top of the screen: 


Since a logical line ranges in size from 1 to 3, SCRFLG ranges 
from © to 2. 


Attract Mode 


Attract mode is a mechanism that protects the television screen 
from having patterns “burned into" the phosphors due to a fixed 
display being left on the screen for extended periods of time. 
When the computer is left unattended for more than 9 minutes, the 
color intensities are limited to SO percent of maximum and the 
hues are continually varied every 8.3 seconds. Pressing any 
keyboard data key will be sufficient to remove the attract mode 
for 9 more minutes. 


As part of the stage 2 VBLANK process, the color registers from 
the data base are sent to the corresponding hardware color 
registers: before they are sent, they undergo the following 
transformation: 


hardware register = database variable XOR COLRSH AND DRKMSK 


Normally COLRSH = $00 and DRKMSK = $FE. thus making the above 
calculation a null operationi however, once attract mode becomes 
active, COLRSH = the content of RTCLOK+1 and DRAMSK = $F6é, that 
has the effect of modifying all of the colors and keeping their 
luminance always below the SO percent level. 


Since RTCLOK+1 is incremented every 254/60 of a second and 
since the least significant bit of COLRSH is of no consequence, a 
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color/lum change will be effected every 8.3 seconds (512/60). 


BiG ATRACT £004D,1] -- Attract mode timer and flag 


ATRACT is the timer (and flag) that controls the initiation and 
termination of attract mode. Whenever a keyboard key is pressed, 
the keyboard IRQ service routine sets ATRACT to zero, thus 
terminating attract modei the CBREAK] key logic behaves 
accordingly. As part of the stage 1 VBLANK process, ATRACT is 
incremented every 4 seconds: if the value exceeds 127 (after 9 
minutes without keyboard activity). the value of ATRACT will 

be set to $FE and will retain that value until attract mode is 
terminated. 


Since the attract mode is prevented and terminated by the OS 
based only upon keyboard activity, some users can want to reset 
ATRACT based upon Atari-controller event detection, 
user~controlled Serial I/0 bus activity or any other signs of 
life. 


Bit COLRSH* COO4F,1] -- Color shift mask 


COLRSH has the value $00 when attract mode is inactive, thus 
effecting no change to the screen colors: when attract mode is 
active, COLRSH contains the current value of the timer variable 
middle digit (RTCLOK+1>. 


Bi2 DRAMSKs (CO004E,1] -- Bark (luminance) mask 


DRKMSK has the value $FE when attract mode is inactive, which does not 
alter the luminance; and has the value $F6 when attract mode 

is active, which forces the most significant bit of the luminance 
field to zero, thus guaranteeing that the luminance will never 

exceed SO percent. 


Tabbing 

See Section S for a discussion of the use of tabs in conyunction 
with the Screen Editor. 

Bi3S TABMAP [£02A3,15] -- Tab stop setting map 

The tab settings are retained in a 15-byte (120 bit} map. where a 


bit value of i indicates a tab setting: the diagram below shows 
the mapping of the individual bits to tab positions. 
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Whenever the Display Handler or Screen Editor is opened. this map 
is initialized to contain the value of $01 in every byte, thus 
providing the default tab stops at 7, 15. 23, etc. 


Logical Text Lines 


The text screen is invisibly divided into logical lines of text, 
each comprising from one to three physical lines of text. The 
screen is initialized to 24 logical lines of one physical line 
each: but data entry and/or data insertion can increase the size 
of a logical line to two or three physical lines. 


Bi4 LOGMAP# CO2B2,4] -- Logical line starting row map 


The beginning physical line number for each logical line on the 
screen is retained in a four byte (32 bit} map, where a bit value 
of one indicates the start of a logical line: the diagram below 
shows the mapping of the individual bits to physical line (row} 
numbers. 


7 6 S$ 43 2 1 =O 


Se ee See oe a Santen Seeman eo 


i Of 1! Bi Bi 4! St &! 7! LOGMAP +0 
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i i i H i H i H H +3 

tm ha pa hae tte pe tent t 
The map bits are all set to 1 whenever the text screen is 
opened or cleared. From that point, the map is updated as 
logical lines are entered, edited and deleted from the screen. 
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BiS LOGCOL# £00463,1] -- Cursor/logical Line column number 


LOGCOL contains the logical-line column number for the current 
cursor position: note that a logical line can comprise up to 
three physical lines. This variable is for the internal use of 
the Display Handler. 


Split Screen 


The Display Handler and Screen Editor together support the 

operation of a split-screen mode (see Section 5) in which the main 
portion of the screen is in one of the graphics modes and is 
controlled by the Display Handler, and there are 4 physical lines in 
the text window at the bottom of the screen which is controlled by the 
Screen Editor. 


Bi6é BOTSCR# CO@BF,1] -- Text screen lines count 
BOTSCR contains the number of Lines of text for the current 
screen: 24 for mode O or 4 for a split-screen mode. The Handler 


also uses this variable as an indication of the split-screen 
statusi tests are made for the specific values 4 and 24. 


DRAW/FILL Function 


The DRAW function line drawing algorithm is shown below 
translated to the PASCAL language from assembly language. 


NEWROW := ROWCRS: NEWCOL := COLCRS; 

DELTAR := ABS (NEWROW-OLDROW); 

ROWINC := SIGN (NEWROW-OLDROW): £ +1 or -1 } 
DELTAC := ABS (NEWCOL-OLDCOL); 

COLINC := SIGN (NEWCOL-OLDCOL); <¢ +1 or ~-i } 


ROWAC := 0; COLAC := 0; 
ROWCRS := OLDROW; COLCRS := OLDCOL: 


COUNTR := MAX (DELTAC, DELTAR); 
ENDPT := COUNTR: 
IF COUNTR = DELTAC 
THEN ROWAC ENDPT DIV 2 
ELSE COLAC ENDPT DIV 2; 


WHILE COUNTR > O DO 
BEGIN 
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ROWAC := ROWAC + DELTAR; 
IF ROWAC >= ENDPT 


THEN 
BEGIN 
ROWAC := ROWAC — ENDPT; 
ROWCRS := ROWCRS + ROWINC 
END; 


COLAC := COLAC + DELTAC; 
IF COLAC >= ENDPT 


THEN 
BEGIN 
COLAC := COLAC — ENDPT; 
COLCRS := COLCRS + COLINC 
END; 


PLOT_POINT; £ point defined by ROWCRS and COLCRS } 
IF FILFLG <> O THEN FILL_LINE; 
COUNTR := COUNTR - 1 

END: 


The FILL function algorithm (FILL_LINE above) is described briefly in 
Section 5. 


B17 FILDAT CO2FD,1] -- Fill data 


FILLDAT contains the fill region data value as part of the calling 
sequence for a FILL command as described in Section 5. 


Bi8 FILFLG# CO2B7,1] -- Fill flag 


FILFLG indicates to the shared code within the Display Handler 
whether the current operation is FILL (FILFLG <> 6} or DRAW 
(FILFLG = 0}. 


Bi? NEWROW# £0060,1] and NEWCOL# £0061.2]3 -- Destination point 
NEWROW and NEWCOL are initialized to the values in ROWCRS and 
COLCRS. which represent the destination endpoint of the DRAW/FILL 


command. This is done so that ROWCRS and COLCRS can be altered 
during the performance of the command. 


B20 HOLD4* CO2BC,1] -- Temporary storage 
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HOLD4 is used to save and restore the value in ATACHR during the 
FILL process: ATACHR is temporarily set to the value in FILDAT to 
accomplish the filling portion of the command. 


B2i ROWINC# (£0079, 11] and COLINC# (C0074,1] -- Row/column 
increment/decrement 


ROWINC and COLINC are the row and column increment values: they 
are each set to +1 or -1 to control the basic direction of line 
drawing. ROWINC and COLINC represent the signs of NEWROW -— 
ROWCRS and NEWCOL - COLCRS, respectively. 


B22 DELTAR# £0076.1] and DELTAC# £0077,2] -- Delta row and delta 
column 


DELTAR and DELTAC contain the absolute values of NEWROW -— ROWCRS 
and NEWCOL - COLCRS. respectively: together with ROWINC and 
COLINC, they define the slope of the line to be drawn. 


B23 COUNTR# COO7E, 2] -- Braw iteration count 


COUNTR initially contains the larger of DELTAR and DELTAC, that 
is the number of iterations required to generate the desired 
line. COUNTR is then decremented after every point on the line is 
plotted, until it reaches a value of zero. 


B24 ROWAC# £0070,21] and COLAC# £0072.,2] -- Accumulators 


ROWAC and COLAC are working accumulators that control the row-and 
column-point plotting and increment (or decrement? function. 


B25 ENDPT# £0074,2] -- Line length 


ENDPT contains the larger of DELTAR and DELTAC. and is used in 
conyunction with ROWAC/COLAC and DELTAR/DELTAC to control the 
plotting of Line points. 


Displaying Control Characters 


Often it is useful to have ATASCII control codes (such as CLEAR, 
CURSOR UP, etc}. displayed in their graphic forms instead of 
having them perform their control function. This display 
capability is provided in two forms when outputting to the Screen 
Editor: 1) a data content form in which a special character (ESC) 
precedes each control character to be displayed and 2) a mode 
control form. 
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Escape (Display Following Control Character} 


Whenever an ESC character is detected by the Screen Editor, the 
next character following this code is displayed as data, even if 
it would normally be treated as a control code: the EOL code is 
the sole exception. It is always treated as a control code. The 
sequence ESC ESC will cause the second ESC character to be 
displayed. 


B26 ESCFLG# CO2A2,1}] -- Escape flag 


ESCFLG is used by the Screen Editor to control the escape 
sequence function: the flag is set (to $80) by the detection of 
an ESC character ($1B) in the data stream and is reset (to 0) 
following the output of the next character. 


Display Control Characters Mode 


When it is desired to display ATASCII control codes other than 
EOL in their graphics form, but not have an ESC character 
associated with each control code, a display mode can be 
established by setting a flag in the data base. This capability 
is used by language processors when displaying high-level 
language statements, that can contain control codes as data 
elements. 


B27 DBSPFLG CO2FE,1] -- Display control characters flag 


When DSPFLG is nonzero, ATASCII control codes other than EOL are 
treated as data and displayed on the screen when output to the 
Screen Editor. When DSPFLG is zero, ATASCII control codes are 
processed normally. 


DSPFLG is set to zero by Power-up and (CSYSTEM. RESET. 


Bit-Mapped Graphics 


A number of temporary variables are used by the Display Handler 
when handling data elements (pixels) going to or from the screen: 
of interest here are those variables that are used to control the 
packing and unpacking of graphics data, where a memory byte 
typically contains more than one data element (for example, 
screen mode @ contains & pixels per memory byte?. 


B28 DMASK# CO2AC0,1] -- Pixel location mask 
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DMASK is a mask that contains zeros for all bits that do not 
correspond to the specific pixel to be operated upon, and 
1’s for all bits that do correspond. DMASK can contain 
the values shown below in binary notation: 

11111111 -- screen modes 1 and 2; one pixel per byte. 


11110000 -- screen modes 9-11; two pixels per byte. 
00001111 


11000000 -- screen modes 3, 5 and 7; four pixels per byte. 
00110000 
00001100 
00000011 


10000000 -- screen modes 4, 6 and 8 eight pixels per byte. 
01000000 | 


00000016 

06000001 
B29 SHFAMT# COO6F,1] -- Pixel justification 
SHFAMT indicates the amount to shift the right-yjustified pixel 
data on output: or the amount to shift the input data to right 


justify it on input. The value is always the same as for DMASK 
prior to the justification process. 


Internal Working Variables 

B3O HOLDix C0051,.11] -- Temporary storage 

B31 HOLD2+ CO29F,11] -—- Temporary storage 

BG2. HOLDS* £029D,11] -~ Temporary storage 

B33 TMPCHR* £0050,11] -- Temporary storage 

B34 DSTAT# CO04C,1] -- Display status 

B35 DINDEX £€0057,1]3 -- Display mode 

DINDEX contains the current screen mode obtained from the low 
order four bits of the most recent OPEN AUXI byte. 

B36 SAVMSC (0058.2) -- Screen Memory Address 

SAVMSC contains the lowest address of the screen data regioni the 
data at that address is displayed at the upper left corner of the 


screen. 
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B37 OLDCHR# (COCGSD,1] -- Cursor character save/restore 
OLDCHR retains the value of the character under the visible text 


cursor; this variable is used to restore the original character 
Value when the cursor is moved. 


B38 OLDADR# COOSE, 2] -- Cursor memory address 
OLDADR retains the memory address of the current visible text 
cursor location; this variable is used in conyunction with OLDCHR 


(B37) to restore the original character value when the cursor is 
moved. 


B39 ADRESS# (0064.2] -- Temporary storage 

B40 MLTTMP/OPNTMP/TOADR# €0066. 2) -- Temporary storage 

B4i SAVADR/FRMADR* £0068.2] -- Temporary storage 

B42 BUFCNT# €006B,1] -- Screen Editor current logical line size 
B43 BUFSTR* (COO6C,2] -- Temporary storage 

B44 SWPFLG# (007B,1]3 -- Gplit-screen cursor control 

In split-screen mode, the graphics cursor data and the text 
window cursor data are frequently swapped as shown below in order 


to get the variables associated with the region being accessed 
into the ROWCRS-OLDADR variables. 


ROWCRS B2 ------- TXTROW B4 
COLCRS Be ------- TXTCOL B4 
DINDEX B35 ------ TINDEX B49 
SAVMSC B36 ------ TXTMSC BS2 
OLDROW BS ------- TXTOLD BS3 
OL DC Ot. B 3 coors ewere tame conan sneey canee cones « a 
OLDCHR B37 ------ “ “a 
OLDADR BSS -~----- " " 


SWPFLG is used to keep track of what data set is currently in the 
ROWCRS-OLDADR region; SWPFLG is equal to SFF when split-screen 
text window cursor data is in the main region. otherwise SWPFLG 
is equal to O. 


B45 INSDAT# (€007D,1] -- Temporary storage 
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B46 TMPROW+ CO2BS,1] and TMPCOL* CO2B9,2] -- Temporary storage 
B47 TMPLBT# CO2Ai,i] -- Temporary storage 
B48 SUBTMP# CO29E,11] -- Temporary storage 


B49 TINDEX® €0293,1] -- Split screen text window screen mode 
TINDEX is the split-screen text window equivalent of DINDEX and is 
always equal to zero when SWPFLG is equal to zero (see B44}. 


BSO BITMSK# COOG6E, 1] -- Temporary storage 


BS1l LINBUF# €0247,40] ~- Physical line buffer 

LINBUF is used to temporarily buffer one physical line of text 
when the Screen Editor is moving screen data. 

BS2 TXTMSC (60294,2] -- Split screen memory address 

TXTMSC is the split-screen text window version of SAVMSC (B36). 


See B44 for more information. 


BS3 TXTOLB# £0296. 4] -- Split screen cursor data 


See B44 for more information. 


Internal Character Code Conversion 


Two variables are used to retain the current character being 
processed (for both reading and writing): ATACHR contains the 
value passed to or from CIO, and CHAR contains the internal code 
corresponding to the value in ATACHR. Because the hardware does 
not interpret ATASCII characters directly, the transformations 
shown below are applied to all text data read and written: 


ATASCIE INTERNAL. 
CODE CODE 
OO-1F 40-5F 
20-3F 00-1F 
40-SF | 20-3F 
60-7F 60-7F 
B0-9F CO~-DF 
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AO-BF 80-9F 
CO-DF AQ-BF 
EO-FF EO-FF 


See P26 for more information. 


B54 ATACHR CO2FB,1] -- Last ATASCII character or plot point 


ATACHR contains the ATASCII value for the most recent character 
read or written, or the value of the graphics point. This 
variable can also be considered to be a parameter of the 
FILL/BRAW commands, as the value in ATACHR will determine the 
line color when a DRAW or FILL is performed. 


BSS CHAR# CO2FA, 1] -—- Internal character code 


CHAR contains the internal code value for the most recent 
character read or written. 


C. DISKETTE HANDLER 


See Section 5 for a discussion of the resident Diskette Handler. 


Ci BUFADR# (£0015,21] -- Data buffer pointer 


BUFADR acts as temporary page zero pointer to the current 
diskette buffer. 


C2 DSKTIM# £(0246,11] -- Disk format operation timeout time 


DSKTIM contains the timeout value for SIO calling sequence 

variable BDTIMLO (see Section 97). DSKTIM is set to 160 (which 
represents a 17i-second timeout) at initialization time, and is 
updated after each diskette status request operation. It contains the 
value returned in the third byte of the status frame (see Section 

3}. Note that all diskette operations other than format have a 

fixed (7) second timeout, established by the Diskette Handler. 


D. CASSETTE 


See Section 5S for a general description of the Cassette Handler. The 
cassette uses the Serial I/0 bus hardware, but does not conform with 
the Serial 1I/0 bus protocol as defined in Section 9. Hence, the Serial 
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I/O utility (SIO} has cassette specific code within it. Some variables 
in this subsection are utilized by SIO and some by the Cassette 
Handler. 


Baud Rate Determination 


The input baud rate is assumed to be a nominal 600 baud, but will 
be adjusted. if necessary, by the SIO routine fo account for 
drive-motor variations, stretched tape, etc. The beginning of 
every cassette record contains a pattern of alternating 1’s and 
zeros that is used solely for speed correction: by measuring the 
time to read a fixed number of bits. the true-receive baud rate 
is determined and the hardware adjusted accordingly. Input baud 
rates ranging from 318 to 1407 baud can theoretically be handled 
using this technique. 


The input baud rate is adyusted by setting the POKEY counter that 
controls the bit sampling period. 


Di CBAUDL# CO2ZEE,1] and CBAUDH* COZEF,11] -- Cassette baud rate 


Initialized to OSCC hex. which represents a nominal 600 baud. 
After baud rate calculation, these variables will contain POKEY 
counter values for the corrected baud rate. 


D2 TIMFLG# €0317,11] -- Baud rate determination timeout flag 


TIMFLG is used by SIO to timeout an unsuccessful baud rate 
determination. The flag is initially set to 1. and if if attains a 
value of zero (after 2 seconds) before the first byte of the cassette 
record has been read. the operation will be aborted. See also H24. 


DG TIMER1# £COSGCC,2] and TIMER2*+ £0310,2] -- Baud rate timers 


These timers contain reference times for the beginning and end of 
the fixed bit pattern receive period. The first byte of each 
timer contains the then current vertical line counter value read 
from ANTIC, and the second byte of each timer contains the then 
current value of the least significant byte of the 05 real time 
clock (RTCLOK+2). 


The difference between the timers is converted to raster pair 


counts and is then used to perform a table lookup with 
interpolation to determine the new values for CBAUDL and CBAUDH. 


D4 ADDCOR# [COSOCE,1] -- Interpolation adyustment variable 
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ADDCOR is a temporary variable used for the interpolation 
calculation of the above computation. 


DS TEMP1i# COSi2,2] -- Temporary storage 
D& TEMPS* £0315,.1] -- Temporary storage 


D7 SAVIO# €03146,1] -—- Serial in data detect 


SAVIO is used to retain the state of SKSTAT €CD2OF] bit 4 (serial 


data ind; it is used to detect (and is updated after) every bit 
arrival. 


Cassette Mode 


DG CASFLG# COSOCF.1] -- Cassette I/0 flag 


CASFLG is used internally by SIO to control the program flow 
through shared code. A value of zero indicates that the current 
operation is a standard Serial I/0 bus operation, and a nonzero 
value indicates a cassette operation. 


Cassette Buffer 


D9 CASBUF# COSFD, 1311] -~- Cassette record buffer 


CASBUF is the buffer used by the Cassette Handler for the packing 
and unpacking of cassette-record data, and by the initialization 
cassette-boot logic. The format for the standard cassette record 
in the buffer is shown below: 


76543210 


tata pa a ta ett 
i01010101: CASBUF +0 
, eam sheets. seats. ced stents stots ste seem 
101010101! +1 
, came theia seats stants ee ston staat aoe 

i control byte i! +2 
tot ttt ttt 

H 128 H +3 
= data = 

H bytes i +130 
» nn sents sents. sheds steeds ston ete see 


See Section 5S for an explanation of the standard cassette-record 
format. 
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DiO BLIM# (CO028A.1] -- Cassette record data size 


BLIM contains the count of the number of data bytes in the 
current cassette record being read. BLIM will have a value 
ranging from i to 128. depending upon the record control byte as 
explained in Section 5. 


Dii BPTR# COO3B,.1] -- Cassette-record data index 


BPTR contains an index into the data portion of the cassette 
record being read or written. The value will range from 0 to the 
then current value of BLIM. When BPTR equals BLIM then the buffer 
(CASBUF) is full if writing or empty if reading. 


Internal Working Variables 


Di2 FEOF# COOSF,1] -- Cassette end-of-file flag 


FEOF is used by the Cassette Handler to flag the detection of an 
end of file condition (control byte = $FE). FEOF equal to zero 
indicates that an EOF has not yet been detected, and a nonzero 
value indicates that an EOF has been detected. The flag is reset 
at every OPEN. 


DiS FTYPE# COOSE.11] -- Interrecord gap type 


FTYPE is a copy of ICAX2Z from the OPEN command and indicates the 
type of interrecord gap selectedi a positive value indicates 
normal record gaps, and a negative value indicates continuous 
mode gaps. . . 


Di4 WMODEs (0289,1] -- Cassette read/write mode flag 

WMODE is used by the Cassette Handler to indicate whether the 
current operation is a read or write operation: a value of zero 
indicates read, and a value of $80 indicates write. 

DiS FREG# £0040.,1] -- Beep count 

FREG is used to retain and count the number of beeps requested of 


the BEEP routine by the Cassette Handler during the OPEN command 
process. . 
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E. KEYBOARD 


See Section 5S for a general description of the Keyboard Handler. 


Key Reading and Debouncing 


The console key code register is read in response to an IRG 
interrupt that is generated whenever a key stroke is detected by 
the hardware. The key code is compared with the prior key code. 
accepted (CHI): if the codes are not identical, then the new code 
is accepted and stored in the key code FIFO (CH) and in the prior 
key code variable (CH1). If the codes are identical, then the new 
code is accepted only if a suitable key debounce delay has 
transpired since the prior value was accepted. 


If the key code read and accepted is the code for (CCTRLJ 1. then 
the display start/stop flag (SSFLAG) is complemented and the 
value is not stored in the key code FIFO (CH}. 


In addition to the reading of the key data, SRTIMR is set to $30 
for all interrupts received (see E88}, and ATRACT is set to 0 
whenever a new code is accepted (see B10}. 


The Keyboard Handler obtains all key data from CH: whenever a 
code is extracted from that i-byte FIFO, the Handler stores a 
value of $FF to the FIFO to indicate that the code has been read. | 
See Section 5 for further discussion of the Keyboard Handlers 
processing of the key codes. 


El CHix €O2F2,1] -- Prior keyboard character code. 

CH1 contains the key code value of the key most recently read and 
accepted. 

E2 KEYDEL# CO2Fi,1] -- BDebounce delay timer. 

KEYDEL is set to a value of 3 whenever a key code is accepted, 
and is decremented every 40th of a second by the stage 2 VBLANK 
process (until it reaches zero). 

ES CH CO2FC,.1] -- Keyboard character code FIFO. 

CH is a i-byte FIFO that contains either the value of the most 
recently read and accepted key code or the value $FF (which 
indicates that the FIFO is empty). The FIFO is normally tread by 
the Keyboard Handler, but can be read by a user program. 

Key data can also be stored into CH by the Autorepeat logic as 


explained in the discussion relating to ES. 
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Special Functions 


Start/Stop 


Display Handler and Screen Editor output to the text or graphics 
mode screen can be stopped and started (without lasing any of the 
output data) through the use of the CCTRLI 1 key combination. 
Each key depression toggles a flag that is monitored by the above 
mentioned Handlers. When the flag is nonzero, the handlers wait 
for it to go to zero before continuing any output. 


E4 SSFLAG CO2FF,1] -- Start/stop flag 


The flag is normally zero, indicating that screen output is not 
to be stopped. The flag is complemented by every occurrence of 
the ECCTRLI 1 key combination by the keyboard IRG service routine. 


The flag is set to zero upon power-up, CSYSTEM. RESET] or CBREAKI 
key processing. 


CBREAK] Key 


ES BRKKEY (€0011,1] -- CBREAK] key flag 


BRKKEY is used to indicate that the CBREAK] key has been pressed. 
The value is normally nonzero and is set to zero whenever the 
CBREAK] key is pressed. The code that detects and processes the 
CBREAK] condition (flag = 0) should set the flag nonzero again. 


BRKKEY is monitored by the following OS routines: Keyboard 
Handler, Display Handler. Screen Editor, Cassette Handler, xx? 
The detection of a CBREAKI] condition during an I/0 operation 
will cause the operation to be aborted and a status of $80 to be 
returned to the user. 


The flag is set to nonzero upon Power-up, CSYSTEM. RESET] or upon 
aborting a pending I/0 operation. 


CSHIFTI/CCONTROL] Lock 


The keyboard control has three different modes for code 
generation that apply to the alphabetic keys A through Z: 
1} normal, 2) caps lock, and 3) control lock. 
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In normal mode, ali unmodified alphabetic character keys generate 
the lowercase letter ATASCII code (%$61-7A)}. 


In caps lock mode, all unmodified alphabetic character keys 
generate the uppercase letter ATASCII code ($41-SA}. 


In control lock mode, all unmodified alphabetic character keys 
generate the control letter ATASCII code ($01-1A). 


In all three modes, any alphabetic character key that is modified 


(by being pressed in conjunction with the CSHIFT] or CCTRLI key) 
will generate the desired modified code. 


E& SHFLOK CO2BE,1] -- Shift/control lock control flag 


SHFLOK normally has one of three values: 


$00 = normal mode (no locks in effect}. 
$40 = caps lock. 
$80 = control lock. 


SHFLOK is set to $40 upon Power-up and CSYSTEM. RESET] and is 
modified thereafter by the OS only when the CCAPS. LOWER] key is 
pressed (either by itself or in conyunction with the CSHIFT] or 
CCTRLI key. 


E7 HOLDCHe CO07C,11] -- Character holding variable © 


HOLDCH is used to retain the current character value prior to the 
CSHIFTI/CCONTROLY logic process. 


Autorepeat 


The Autorepeat feature responds to the continuous depression of a 
keyboard key by replicating the key code 10 times per second, 
after an initial 1/2 second delay. The timer variable SRTIMR is 
used to control both the initial delay and the repeat rate. 


Whenever SRTIMR is equal to zero and a key is being held down, 
the value of the key code is stored in the key code FIFO (CH). 
This logic is part of the stage 2 VBLANK process. 


ES SRTIMR# CO22B,1] -- Autorepeat timer 


SRTIMR is controlled by two independent processes: 1) the 
keyboard IRQ service routine, which establishes the initial delay 
value and 2) the stage 2 VBLANK routine that establishes the 
repeat rate, decrements the timer and implements the auto repeat 
logic. 
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Inverse Video Control 


The Keyboard Handler allows the direct generation of more than 
half of the 256 ATASCII codes: but codes $80-9A and codes $A0O- FC 
can be generated only with the “inverse video mode" active. The 
ATARI key acts as an on/off toggle for this mode, and all 
characters (except for screen editing control characters) will be 
subyect to inversion when the mode is active. 


E9 INVFLG £02B6.,1] -- Inverse video flag 

INVFLG is normally zero, indicating that normal video ATASCII 

codes (bit 7 = 0) are to be generated from keystrokes; whenever INVFLG 
is nonzero, inverse video ATASCII codes (bit 7 = 1) will be generated. 
The special control codes are exempt from this bit manipulation. 
INVFLG is set to zero by power-up and system reset. 

The Keyboard Handler inverts bit 7 of INVFLG whenever the ATARI key 

is pressed; the lower order bits are not altered and are assumed to be 
zero. 

The Keyboard Handler’s “exclusive or’s" (XOR‘’s} the ATASCII key data 


with the value in INVFLG at all times; the normal values of $00 and 
$80 thus lead to control of the inverse video bit (bit 7). 


Console Keys: (CSELECTI,CSTARTI], and COPTION) 
The console keys are sensed directly from the hardware 


register CONSOL [€DOIFIJ: see the ATARI Home Computer 
Hardware Manual for details. 


F. PRINTER 


See Section S for a general description of the Printer Handler. 


Printer-Buffer 
Fi PRNBUF# £03C0, 40] -- Printer-record buffer 


PRNBUF is the buffer used by the Printer Handler for packing printer 
data to be sent to the device controller. The buffer is 40 bytes long 
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and contains nothing but printer data. 


F2 PBUFSZ# COO1E, 13] -- Printer-record size 


PBUFSZ contains the size of the Printer-record for the current mode 
selected: the modes and respective sizes (in decimal bytes) are shown 
below: 


Normal 40 
Double width 20 (not currently supported by the device) 
Sideways 29 


Status request 4 


F3 PBPNT# COO1D,11] -- Printer-buffer index 


PBPNT contains the current index to the Printer-buffer. PBPNT ranges 
in value from zero to the value of PBUFSZ. 


Internal Working Variables 


F4 PTEMP# COO1F,1] -- Printer Handler temporary data save 


PTEMP is used by the Printer Handler to temporarily save the value of 
a character to be output to the printer. 


FS PTIMOT# COOiIC,1] -- Printer timeout value 

PTIMOT contains the timeout value for SIO calling sequence variable 
DTIMLO (see Section 9); PTIMOT is set to 30 (which represents a 32 
second timeout) at intialization time, and is updated after each 


printer status request operation to contain the value returned in the 
third byte of the status frame (see Section 5}. 


G. CENTRAL 1/0 ROUTINE (CIO} 
See Section 5 for a description of the Central I/0 Utility. 


User Call Parameters 
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CIO call parameters are passed primarily through an I/0 Control 
Block (IOCB); although additional device status information can be 
returned in DVSTAT., and Handler information is obtained from the 
device table (CHATABS). 


1/0 Control Block 


IOCB is the name applied collectively to the 14 bytes associated 
with each of the & provided control structures: see Section 5. 


Gi IOCB £€0340,16] -- 1/0 Control Block 


The label I0CB is the location of the first byte of the first IOCB in 
the data base. For VIBs G2 through G10, the addresses given are for 
IOCB #0 only, the addresses for all of the IOCB’s are shown below: 


0340-034F IOCB #0 
0350-O35F IOCB #1 
0360-O036F IOCB #2 
0370-037F IOCB #3 
0380-O038F IOCE #4 
0390-O039F IOCB #5 
O3A0-O3AF IOCB #6 
OSBO-OSBF IOCB #7 


G2 ICHID £0340,13 -- Handler ID 


Gee Section 5. Initialized to $FF at power-up and system reset. 


G3 ICDNO £0341,1] -- Device number 


See Section 5. 


G4 ICCOM £0342,1] ~~ Command byte 


See Section 5. 


GS ICSTA £6343,1] -- Status 


See Section 5. 


G6 ICBAL, ICBAH £0344,2] -- Buffer address 


See Section 5. 
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G7 ICPTL, ICPTH €0346,2] -- PUT BYTE vector 


See Section 5. Initialized to point to CIO’s “IOCB not OPEN" routine 
at power-up and system reset. 


GB ICBLL, ICBLH (6348,2] -- Buffer length / byte count 


See Section 5. 


G9 ICAX1, ICAX2 CO34A,2] -- Auxiliary information 


See Section 5. 


G10 ICSPR (034C,41] -- Spare bytes for Handler use 


There is no fixed assignment of these four bytes; the Handler 
associated with an IOCB can or may not use these bytes. 


Device Status 


Gil DVSTAT CO2EA, 4] -- Device status 


See Section 5 for a discussion of the GET STATUS command. 


Device Table 


Gi2 HATABS COS1A,. 36] -- Device table 


See Section 9 for a description of the device table. 


CiO/Handler Interface Parameters 


Communication between CIO and a Handler is accomplished using the 
6502 machine registers, and a data structure called the Zero-page 
IOCB (ZIOCB). The ZIOCB is essentially a copy of the particular 
IOCB being used for the current operation. 
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Zero~-Page IOCB 


G13 ZIOCB (IOCBAS) [0020.16] -- Zero-page IOCB 

The Zero-page IOCB is an exact copy (except as noted in the | 
discussions that follow) of the IOCB specified by the 6502 X 
register upon entry to CIO; CIO copies the outer level IOCB to 
the Zero~page IOCB., performs the indicated function, moves the 
(possibly altered) Zero-page IOCB back to the outer level IOCB, 
and then returns to the caller. 

Although both the outer level IOCB and the Zero-page IOCB are 
defined to be 16 bytes in size, only the first 12 bytes are moved 
by CIO. 

G14 ICHIDZ €0020,113 -- Handler index number 


See Section 5S. Set to $F°F on CLOSE. 


GiS ICDNOZ CO021,1] -- Device drive number 


See Section 5. 


Gié ICCOMZ CO0022,1] -- Command byte 


See Section 5. 


Gi7 ICSTAZ (0623.11 -- Status byte 


See Section 5. 


G18 ICBALZ. ICBALH [0024,2] -- Buffer address 
See Section S. This pointer variable is modified by CIO in the 


course of processing some commandsi however, the original value 
is restored before returning to the caller. 


Gi? ICPTLZ, ICPTHZ 

See Section S. Set to point to CIO’s “IOCB not OPEN" routine on 
CLOSE. 

G20 ICBLLZ, ICBLHZ €0028.2] -- Buffer length / byte count 


See Section S. This double-byte variable, which starts out 
representing the buffer length, is modified by CIO in the course 
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of processing some commands: then, before returning to the 
caller, the transaction byte count is stored therein. 
G2il ICAXiZ, ICAX2Z COO2A, 2] -- Auxiliary information 


See Section 5. 


G22 ICSPRZ (ICIDNO, CIOCHR? CO02C,4] -- CIO working variables 


ICSPRZ and ICSPRZ+1i are used by CIO in obtaining the appropriate 
Handler entry point from the handler’s vector table (see Section 9). 


ICSPRZ+2 is also labeled ICIDNO and retains the value of the 6502 X 
register from CIO entry. The X register is loaded from ICIDNO as CIO 
returns to the caller. 

ICSPRZ+3 is also labeled CIOCHR and retains the value of the 6502 A 
Tegister from CIO entry, except for data reading type commands, in 


which case the most recent data byte read is stored in CIOCHR. The 
6502 A register is loaded from CIOCHR as CIO returns to the caller. 


Internal Working Variables 

G23 ICCOMT# €0017,1] -- Command table index 

ICCOMT is used as an index to CIO’s internal command table, which maps 
command byte values to Handler entry offsets (see Section 9 for more 


information). ICCOMT contains the value from ICCOMZ except when ICCOMZ 
is greater than $0E, in which case ICCOMT is set to $0E. 


G24 ICIDNO# COG2E.1] -- CIO call X register save/restore 


See Gee. 


G25 CIOCHR* (COO2F,1] -- CIO call A register save/restore 


See Gee. 


H. SERIAL I/0 ROUTINE (SIO) 


See Section 9 for discussions relating to SIO. 
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User Call Parameters 


SIO call parameters are passed primarily through a Device Control 
Block: although an additional “noisy bus" option exists that is 
selectable through a separate variable. 


Device Control Block 


Hi DCB CO300.12] -- Device Control Block 


DCB is the name applied collectively to the 12 bytes at locations 
OGOO~-OSOB. These bytes provide the parameter passing mechanism for SIO 
and are described individually below. 


H2 DDEVIC €0300.1] -- Device bus ID 


See Section 9. 


H3 DUNIT £€0301,11 ~- Bevice unit number 


See Section 9. 


H4 DCOMND (€0302,11 -- Device command 


See Section 9. 


HS DSTATS £0303,11] -- Device status 


See Section 9. 


H& DBUFLO, DBUFHI (€0304,2] -- Handler buffer address 


See Section 9. 


H7 DTIMLO £0306,11] -- Device timeout 


See Section 9. 
HS DBYTLO. DBYTHI (CO308,2] -- Buffer length / byte count 


See Section . 
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H? DAUX1, DAUX2 COSCA, 2] -- Auxiliary information 


See Section 9. 


Bus Sound Control 


H1iG SOUNDR [0041.1] -- Quiet/noisy I/0 flag 


SOUNDR is a flag used to indicate to SIO whether noise is to be 
generated on the television audio circuit when Serial I/O bus 
activity is in progress. SOUNDR equal to zero indicates that 
sound is to be inhibited, and nonzero indicates that sound is to 
be enabled. SIO sets SOUNDR to 3 at power-up and system reset. 


Serial Bus Control 

Retry Logic 

SIO will attempt one complete command retry if the first attempt 
is not error free, where a complete command try consists of up to 


14 attempts to send (and acknowledge) a command frame, followed 


by a single attempt to receive COMPLETE and possibly a data 
frame. 


Hil CRETRY# (€0036,1] -- Command frame retry counter 


CRETRY controls the inner loop of the retry logic, that associated 


with sending and receiving an acknowledgement of the command frame. 


CRETRY is set to 13 by SIO at the beginning of every command 
initiation, thus allowing for an initial attempt and up to i3 
additional retries. 


Hi2 DRETRY# (€0037,1]3] -- Device retry counter 


DRETRY controls the outer loop of the retry logic, that 
associated with initiating a command retry after a failure 
subsequent to the command frame acknowledgement. DRETRY is set to 
1 by SIO at entry. thus allowing for an initial attempt and 

1 additional retry. 
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Checksum 


The Serial I/0 bus protocol specifies that all command and data 
frames must contain a checksum validation byte: this byte is the 


arithmetic sum (with end-around carry) of all of the other bytes 
in the frame. 


H13 CHKSUM# [£0031,1] -- Checksum value 


CHKSUM contains the frame checksum as computed by SIO for all frame 
transfers. 


H14 CHASNT# COO3B,.11 -~ Checksum sent flag 


CHKSNT indicates to the serial bus transmit interrupt service 
routine whether the frame checksum byte has been sent yet. CHKSNT 
equal to zero indicates that the checksum byte has not yet been 
sent; after the checksum is sent, CHKASNT is then set nonzero. 


HIS NOCKSM# £003C,1] -~- No checksum follows data flag 


NOCKSM is a flag used to communicate between the SIO top level 

code and the Serial bus receive interrupt service routine that 

the next input will not be followed by a checksum byte. A value 

of zero specifies that a checksum byte will follow, nonzero specifies 
that a checksum byte will not follow. 


Data Buffering 
General Buffer Control 


Hi6& BUFRLO# (£0032,11] and BUFRHI# (C0033. 1] -- Next byte address 


BUFRLO and BUFRHI comprise a pointer to the next buffer location 
to be read from or written to. For a data frame transfer, the 
pointer is initially set to the value contained in the SIO call 
parameters DBUFLO and DBUFHI, and is then incremented by the 
interrupt service routines as a part of normal bus data transfer. 
For a command frame transfer, the pointer is set to point to the 
SiO0-maintained command frame output buffer. 


Hi7 BFENLO# €0034,1] and BFENHI# £€0035,11] -- Buffer end address 


BFENLO/BFENHI form a pointer to the byte following the last frame 
data byte (not including the checksum) to be sent or received. 
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BFENLO/BFENHI is the arithmetic sum of BUFRLO/BUFRHI plus the 
frame size plus -1. 


Command Frame Output Buffer 


See Section 9 for the command frame format and description. 


H1i8 CDEVIC# CO23A.1] --— Command frame device ID 

CDEVIC is set to the value obtained by adding SIO call parameter 
DDEVIC to DUNIT and subtracting 1. 

H1i9 CCOMND* (CO23B,1] -- Command frame command. 

CCOMND is set to the value obtained from SIO call parameter 
DCOMND. 

H20 CAUXI# CO23SC,.1] and CAUX2* (€O023D,1] -- Auxiliary information 


CAUX1L and CAUX2 are set to the values obtained from SIO call 
parameters DAUX1 and DAUX2., respectively. 


Receive/Transmit Data Buffering 


H2i BUFRFL* COO38,1] -- Buffer full flag 


BUFRFL is a flag used by the serial bus receive interrupt service 
routine to indicate when the main portion of a bus frame has been 
received -- all but the checksum byte. BUFRFL equal to zero 
indicates that the main portion has not been completely received, 
a nonzero value indicates that the main portion has been 
received. 


H22 RECVDN# £0039.1] -- Receive frame done flag 

RECVDN is a flag used by SIO to communicate between the Serial 
bus receive interrupt service routine and the main SIO code. The 
flag is initially set to zero by SIO. and later set nonzero by 
the interrupt service routine after the last byte of a bus frame 
has been received. 


H23 TEMPs CO23E,1] -- SIO i-byte I/0 data 
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TEMP is used to receive i-byte responses from serial bus 
controllers, such as ACK, NAK, COMPLETE or ERROR. 


H24 XMTDON# (£003A.11] -- Transmit frame done flag 


XMTDON is a flag used by SIO to communicate between the Serial 
bus transmit interrupt service routine and the main SIO code. The 
flag is initially set to zero by SIO. and later set nonzero by 
the interrupt service routine after the last byte of a bus frame 
has been transmitted. 


SIO Timeout 


SIO uses System Timer 1 to provide the timeout capability for 
various operations initiated internally. See Section 6 for a 
discussion of the capabilities of the System Timers. TIMFLG is 
the flag used to communicate between SIO and the timer initiated 
code pointed to by CDTMA1. 


H25 TIMFLG# £0317.1] -- SIO operation timeout flag 


TIMFLG is used to indicate a timeout situation for a bus 
operation . The flag is initially set to 1. and if it attains a 
value of zero (after the timeout period) before the current 
operation is complete, the operation will be aborted. See also 
D2. 


H26 CDITMVis €0218.21] -- System Timer 1 value 


This 2-byte count takes on various values depending upon the 
operation being timed. See also P4. 


H27 CDTMAi# £O0226.21] -- System Timer 1 address 


This vector always points to the JTIMER routine, whose only 
function is to set TIMFLG to zero. This vector is initialized by 
SIO before every use, so that System Timer i can be used by any 
process that does not use SIO within a timing function. See also 
PS. 
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Internal Working Variables 


H28 STACKP# (€0318,11] -- Stack pointer save/restore 
STACKP contains the value of the 6502 SP register at entry to 


SIO; this is retained to facilitate a direct error exit from an 
SIO subroutine. 


H29 TSTAT# £0319,1] -- Temporary status 


TSTAT is used to return the operation status from the WAIT 
routine and will contain one of the SIO status byte values as 
shown in Appendix B. 


H3Q0 ERRFLG* CO23F,1] -- 1/0 error flag 
ERRFLG is used for communication between the WAIT routine and the 


outer level SIO code. ERRFLG is normally zero. but is set to $FF 
when a device responds with an invalid response byte. 


H3i STATUS# £0030,1] -- SIO operation status 
STATUS is a zero-page variable that is used within SIO to contain 


the operation status that will be stored to the calling sequence 
parameter variable DSTATS when SIO returns to the caller. 


H32 SSKCTL* CO232.,13] -—- SKCTL copy 


SSKCTL is utilized by SIO to keep track of the content of the 
SKCTL €D2O0F] register. which is a write-only register. 


J. ATARI CONTROLLERS 
The ATARI controllers are read as part of the Stage 2 VBLANK 


process. The encoded data is partially decoded and processed as 
shown in the subsections that follow. 


Joysticks 


Up to four joystick controllers can be attached to the computer 
console, each with a P-position joystick plus a trigger button. 
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J1 STICKO —- STICKS £0278,4] -- Joystick position sense 


The 4 joystick position sense variables contain a bit-encoded: 
position sense as shown below: 


7&4$3$ 43210 
siete ea senate sheets see staat ara at 
10 0 GO GIRILIDIU! 
See Sent seats seats ste steete set ate 
where: indicates joystick RIGHT sensor true. 
indicates joystick LEFT sensor true. 
indicates joystick DOWN sensor true. 
indicates joystick UP sensor true. 


corsa 
i a 
OoOo008 


Nine unique combinations are possible, indicating the possible 
Joystick positions shown below: 


CENTER $OF 
UP $0E 
UP /RIGHT $06 
RIGHT $07 
DOWN/RIGHT $05 
DOWN $OD 
DOWN/LEFT $09 
LEFT $0OB 


UP /LEFT $O0A 


J2 STRIGO —- STRIGS [0284,4] -- Joystick trigger sense 
The four joystick trigger sense variables each contain a single bit. 


indicating the position of the joystick trigger as shown below: 


76834321 6 
$$ — 4 — 4 
1000000 OT! 
See ele ete ce deeds eee ee a 


where: T = 0 indicates trigger pressed. 


Paddles 

Up to eight paddle controllers can be connected to the computer, 
each with a potentiometer and a trigger sense. 

J3 PADDLO —- PADDL7 (0270,8] -- Paddle position sense 


There is a single-byte variable associated with each paddle 
position sense: the values range from 228 for full 
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counterclockwise rotation to 1 for full clockwise rotation. 


The paddle values are often converted by the user, as shown 
below, to give a result of O for full counterclockwise rotation 
and 227 for full clockwise rotation: 


VALUE := 228 - PADDLX;: 
J4 PTRIGO - PTRIG7 [O27C,8] -- Paddle trigger sense 


The S-paddle trigger sense variables each contain a single bit 
indicating the position of the paddle trigger as shown below: 


7645432106 
tote pant tt 4 + 
i0 00000 O0ITi 
Sa steats dents shen ets steete atees erat 


where: T = 0 indicates trigger pressed. 


Light Pen 


The OS reads the position of a single light pen and stores the 
horizontal and vertical position codes in two variables: these codes 
are not the same as the actual screen coordinates. The pen position 
codes for different portions of the screen are shown below: 


Left edge -- 47. 
Codes increase in increments of one to a value of 227, then go to 0 
and continue to increase monotonically (one count per color clock). 
Right edge -- 7. 


Upper adge -- 164. 
Codes increase in increments of one Cone SOUS per two HAS Sy. 
lines). Lower edge -- i111. 


The light pen hardware will read and latch the pen position 650 times 
per second, independent of the pen button position, which is 
separately sensed. 


In order for the light pen to operate it must be positioned over a 
portion of the screen which has sufficient luminance to activate the 
photosensor in the pen; a blank (dark) screen will generally not 
provide enough luminance to utilize the light pen. 


JS LPENH £0234.,1] -- Light pen horizontal position code 
LPENH contains the horizontal position code for the light pen; the 
algorithm below (written in Pascal) shows the conversion from position 


code to screen coordinate (screen mode 7}: 


IF LPENH < 33 £ check for rollover point } 
THEN { adjust values to right of rollover } 
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XPOS := LPENH + 227 
ELSE £ no adyustment to left of rollover point } 
XPOS := LPENH: . . 
XPOS := XPOS — 67; { adyust for left edge offset } 
IF XPOS < GO THEN XPOS := OQ; 
IF XPOS > 159 THEN XPOS := 159; 


J@ \LPENV £0235, 11] -- Light pen vertical position code 


LPENY contains the vertical position code for the light pen: the 
algorithm below (written in Pascal) shows the conversion from position 
code to screen coordinate (screen mode 7}: 


YPOS := LPENV - 16; <{ adyust for upper edge offset } 
IF YPOS < O THEN YPOS := 0; 
IF YPOS > 95 THEN YPOS := 95; 


J7 STICKO —- STICKS £0278, 4] -- Light pen button sense 


The light pen button sense is encoded in one of STICKO —- STICKS 
(depending upon the actual controller port used) as shown 
below: 


7 0 
tot a pt — + 
i fO1rolroriri 
Seals Senta stem stants sete stat see ates 


where: T = 0 indicates the light pen button is pressed. 


Driving Controllers 


The driving controller has no position stops and thus allows unlimited 
rotation in either direction; the output of the controller is a 22-bit 
Gray code which can be used to determine the direction of rotation. 
The controller is sensed using the same internal hardware as the 
joystick, thus the same data base variables are used for both. 
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J8 STICKO - STICKS £0278, 41 -- Driving controller sense 


The 4 driving controller sense variables contain an encoded 
rotation (position) sense value, as shown below: 


76343210 
$$ ht 
i060 0001 Livalt 
taba ba ha a 


where a clockwise rotation of the controller produces the following 
continuous sequence of four values (shown in hexadecimal}: 


OF, OD, OC, OF, OF, OB, ....... 


and a counterclockwise rotation of the controller produces the 
following continuous sequence of four values: 


OF, OF, OC, OD, OF, OF,....... 


J9 STRIGO —- STRIGS £0284,4] -- Driving trigger sense 


The four driving trigger sense variables each contain a single bit 
indicating the position of the driving trigger as shown below: 


76543210 
++ — 4-4 — 4-4 — 4-4 
i000000 O'T! 
Scams stants stam stemie seams ston ste ao 


where: T = O indicates trigger pressed. 


K. DISK FILE MANAGER 

See Section 5 for information relating to the Disk File Manager. 

Ki FMSZPG# (0043,7] -- FMS reserved space 

FMSZPG is the reserved space in the database for the variables shown 


below; the names associated with K2 through KS are not in the system 
equate file. 


K2 ZBUFP# (C0043,2] -- Buffer pointer 
K3 ZDRVA* (0045.21 -- Drive pointer 
K4 ZSBA# £0047,21 -- Sector buffer pointer 
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KS ERRNO#* £0049,1] -- Error number 


L. DISK UTILITY POINTER 


Li DSKUTL® {COO1A,2] -- Page-zero pointer variable 


M. FLOATING POINT PACKAGE 


See Section 8 for a description of the Floating Point Package. 
M1 FRO CO0OD4,461 -- FP register 0© 

M2 FRE# COODA. 6] ~-- FP register (internal? 

M3 FRi COOEO, 6] ~~ FP register 1 

M4 FR2*% COOE6. 6] -- FP register 2 (internal) 

MS FRX# COOCEC,1] -- Spare (unused) 

M6 EEXP# COOCED, 1] -—- Exponent value (internal 

M7 NSIGN® CGOEE,1] -- Sign of mantissa (internal) 

MS ESIGN# COOEF,1] -- Sign of exponent (internal) 

M9? FCHRFLG# COOFO, 1] ~- First character flag (internal) 
M10 DIGRT# (COOF1,11] -- Digits to right of decimal point 
M11 CIX COOF2, 1] -~ Character index 


M12 INBUFF COOFS,2] -- Input text buffer pointer 
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M13 ZTEMP1i# COOFS,2] -— Temporary storage 


M14 ZTEMP4s COOF7,2] -- Temporary storage 


M15 ZTEMPS# COOFS,2] -- Temporary storage 


M16 FLPTR COOFC,2] -- Pointer to FP number 


M17 FPTR2* COOFE, 2] 


FP package use 


MiS8 LBPRi# COS7E,11 - 


LBUFF preamble 


M19 LCBPR2* COS7F, 1] LBUFF preamble 


M20 LBUFF COS580, 94] 


Text buffer 

M21 PLYARG# COSEO, 4] -- FP register (internal) 

M22 FPSCR/FSCR* COSES, 6] -- FP register (internal) 
M23 FPSCRi/SCRi* COSEC,6] -- FP register (internal? 
M24 DEGFLG/RADFLG COOFB,1] -- Degrees/radians flag 


DEGFLG = © indicates radians, & indicates degrees. 


N. Power-Up and SYSTEM RESET 


See Section 7 for details of the power-up and system reset 
operations. 


RAM Sizing 


During power-up and system reset the first non-RAM address above 1000 
hex is located and its address retained using a nondestructive 

test. The first byte of every 4K memory “block” is tested to see if 
it is alterable; if so, the original value is restored and the next 
block is tested, and if not. that address is considered to be the 

end of RAM. 
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Ni RAMLO#/TRAMSZ# [0004.3] -~- RAM data/test pointer (temporary) 


RAMLO+1 contains the LSB of the address to be tested (always = 0) 
and TRAMSZ (same as RAMLO+2) contains the MSB of the address to be 
tested. RAMLO+0 contains the complemented value of the data 
originally contained in the memory location being tested. 


Later in the initialization process these variables are used for 
totally unrelated functions: but first the value in TRAMSZ is moved 
to the variables RAMSIZ and MEMTOP+1. 


N2 TSTDAT# £0007,113 -- Test data byte save 


TSTDAT contains the original value of the memory location being 
tested. . 


Diskette/Cassette-Boot 


As a part of the Power-up sequence, software can be booted from an 
attached disk drive or cassette player as explained in Section 10. 


N3 DOSINI (C000C,2] -- Diskette-boot initialization vector. 


DOSINI contains the disk booted software initialization address 
from the beginning of the boot file (see Section 10) whenever a 
diskette-boot is successfully completed. 


N4 CKEY# £604A.1] -- Cassette-boot request flag 


CKEY is an internal flag used to indicate that the console CSTARTI 
key was pressed during Power-up, thus indicating that a 
cassette-boot is desired. CKEY equals zero when no cassette-boot is 
requested, and is nonzero when a cassette-boot is requested. The 
flag is cleared to zero after a cassette-boot. 


NS CASSBT# £004B8,1] -- Cassette-booting flag 

CASSBT is used during the cassette-boot process to indicate to 

shared code that the cassette is being booted and not the diskette. 
CASSBT equal to zero indicates a diskette-boot, and nonzero indicates 
a cassette-boot. 


N& CASINI (£C0002.,2] -- Cassette-boot initialization vector 


CASINI contains the cassette-booted software initialization address 
from the beginning of the boot file (see Section 10) whenever a 
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cassette-boot is successfully completed. 


N7 BOOT?# £0009,11 -- Successful diskette/cassette-boot flag. 


BOOT? indicates to the initialization processor which, if any, of 
the boot operations went to successful completion. The flag values 
are set by the OS and the format for the variable is shown below: 


74543210 
Scat stents steets steet seeats ahead eee create 
H iciDi 
tt 4 — 4 4 4 


where: 1 indicates that the cassette-boot was completed. 


C 
BD 1 indicates that the diskette-bhoot was completed. 


NG@ DFLAGS# £0240.,11] -- Diskette flags 


DFLAGS contains the value of the first byte of the boot file, after a 
diskette-boot. See Section 10. 


NS DBSECT# £€0241,1] -- Diskette-boot sector count 


DBSECT is initially set to the value of the second byte of the boot 
file, during a diskette-boot, and is then used to control the number 
of additional diskette sectors read, if any. 


NiO BOOTAD+ (CO0242,2] -- Diskette-boot memory address 


BOOTAD is initially set to the value of the third and fourth 
bytes of the boot file, during a diskette-boot, and is not 
modified thereafter. 


Environment Control 


If, at the end of a power-up or system reset, control is not 

given to one of the cartridges (as explained in Sections 7 and 10), 
then program control passes to the address contained in the data 
base variable DOSVEC. 


Nii COLDST# (0244,1] -- Coldstart complete flag 
COLDST is used by the initialization routine to detect the case of 
a system reset occurring before the completion of the power-up 


process. COLDST is set to S$FF at the beginning of the power-up 
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sequence and is set to O at the completion: if a system reset 
occurs while the value is nonzero, the power-up sequence will be 
reinitiated (rather than initiating a system reset sequence). 


Ni2 DOSVEC (C0O00A, 2] -- Noncartridge control vector 


At the beginning of power-up the OS sets DOSVEC to point to the 
“blackboard” routine; DOSVEC can then be altered as a consequence 
of a diskette-boot or cassette-boot (as explained in Section 10) to 
establish a new control program. Control will be passed through 
DOSVEC on all power-up and system reset conditions in which a 
cartridge does not take control first. 


System Reset 


Ni3 WARMST (0008.,1] -- Warmstart flag 


WARMST equals S$FF during a system reset (warmstart>} 
initialization and equals © during a power-up initialization 
(coldstart}>. 


P. INTERRUPTS 


See Section & for a discussion of interrupt processing. 


Pi CRITIC (€0042,1] -- Critical code section flag 


CRITIC is used to signal to the VBLANK interrupt processor that a 
critical code section is executing without IRG interrupts being 
inhibitedi the VBLANK interrupt processor will stop interrupt 
processing after stage 1 and before stage 2, just as if the 6502 
processor [I bit were set, when CRITIC is set. 


CRITIC equal to zero indicates that the currently executing code 
section is noncritical, while any nonzero value indicates that the 
currently executing code section is critical. 


P2 POKMSK £0010,11] -- POKEY interrupt mask 


POKMSK is a software maintained interrupt mask that is used in 
conygunction with the enabling and disabling of the various POKEY 
interrupts. This mask is required because the POKEY interrupt 
enable register IRGEN (D20E] is a write-only register, and at any 
point in time the system can have several users independently 
enabling and disabling POKEY interrupts. POKMSK is updated by the 
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users fo always contain the current content of IRGEN. 


System Timers 


The System Timers are discussed in detail in Section 6. 


Realtime Clock 

The realtime clock (Cor frame counter, as it is sometimes called) 
is incremented as part of the stage 1 VBLANK process as explained 
in Section &. 

P3 RTCLOK £0012,3] -- Realtime frame counter 

RTCLOK+O is the most significant byte, RTCLOK+1 the next most 


significant byte, and RTCLOK+2 the least significant byte. See the 
discussions at DG and preceding BiO for OS use of RTCLOK. 


System Timer 1 

System Timer 1 is maintained as part of the stage 1 VBLANK process, 
and thus has the highest priority of any of the user timers. 

P4 CDBTMV1i £€0218,2] -- System Timer 1 value 

CDTMVi contains zero when the timer is inactive, otherwise it 


contains the number of VBLANKs remaining until timeout. Also see 
H26. 


PS CBITMAL €0226,2] ~- System Timer 1 jump address 


CDTMAi contains the address to which to JSR should the timer | 
timeout. See also H27 and Section 4. | : 
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System Timer 2 

System Timer 2 is maintained as part of the stage 2 VBLANK process, 
and has the second highest priority of the user timers. The OS does 
not have any direct use for System Timer 2. 

P& CDITMV2 (£621A,2] -- System Timer 2 value 

CDTMV2 contains zero when the timer is inactive, otherwise it 
contains the number of VBLANKs remaining until timeout. 

P7 CDTMA2 [0228.2] ~-- System Timer 2 jump address 


CDTMA2 contains the address to which to JSR should the timer 
timeout. See Section 6. 


System Timers 3. 4 and 5 


System Timers 3. 4 and 5S are maintained as part of the stage 2 
VBLANK process, and have the lowest priority of the user timers. 
The OS does not have any direct use for these timers. 


P8 CDTMVS3 £621C,.2], CDIMV4 COZ1iE, 21 and CDTMVS [O220, 2] 

These variables contain zero when the corresponding timers are 
inactive, otherwise they contain the number of VBLANKs remaining 
until timeout. 

P9 CDTMFS (CO22A.1]. CDIMF4 CO22C,11] and CDIMFS (O22E, 2] 

Each of these i-byte variables will be set to zero should its 
corresponding timer timeout. The OS never modifies these bytes 
except to set them to zero upon timeout (and initialization). 

RAM Interrupt Vectors 

There are RAM vectors for many of the interrupt conditions within 


the system. See Section 6 for a discussion of the placing of values 
to these vectors. 
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NMI Interrupt Vectors 


P10 VDSLST [0200.2] -- Display-list interrupt vector 


This vector is not used by the OS. See Section 4. 


P11 VVBLKI £0222,2] -- Immediate VBLANK vector 


This vector is initialized to point to the OS stage 1 VBLANK 


Pi2 VVBLKD £0224,2] --— Deferred VBLANK vector 


This vector is initialized to point to the OS VBLANK exit routine. 
See Section &. 


IRQ Interrupt Vectors 


Pi3 VIMIRG@ €0216,21] -- General IRG@ vector 


This vector is initialized to point to the OS IRQ@ interrupt 
processor. See Section 6. 


P14 VPRCED (€0202,2] -- Serial 1/0 bus proceed signal 


The serial bus line that produces this interrupt is not used in the 
current system. See Section 6. 


PiS VINTER £0204,2] -- Serial I/0 bus interrupt signal 


The serial bus line that produces this interrupt is not used in the 
current system. See Section 4. 


P16 VECBREAK] £0206, 2] -- BRK instruction vector 


This vector is initialized to point to a PLA, RTI sequence as the 
OS proper does not utilize the BRK instruction. See Section 6. 


P17 VKEYBD (£0208,2] -- Keyboard interrupt vector 
This vector is initialized to point to the Keyboard Handler ‘s 


interrupt service routine. See Section 6 and the discussion 
preceding E1. 
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P18 VSERIN £62GCA,2] -- Serial I/0 bus receive data ready 

This vector is initialized to point to the SIO utility’s interrupt 
service routine. See Section 6. 

P19 VSEROR £020C,2] -- Serial I/O bus transmit ready 

This vector is initialized to point to the SIO utility’s interrupt 
service routine. See Section &. 

P20 VSEROC CO20E,2] -- Serial I/O bus transmit complete 

This vector is initialized to point to the SIO utility’s interrupt 
service routine. See Section 6&. | 
P21 VTIMRi CO210,2]), VTIMR2 CO212.2] and VTIMR4 €0214,2] -—- POKEY 


timer vectors 


The POKEY timer interrupts are not used by the OS Gee Section 6. 


Hardware Register Updates 


As part of the stage 2 VBLANK process, certain hardware registers 
are updated from OS data base variables as explained in Section 6. 


P22. SDMCTL# CO22F,1] -- BMA control 


SDMCTL is set to a value of $02 at the beginning of a Display 
Handler OPEN command, and then later set to a value of $22. The 
value of SDMCTL is stored to DMACTL [D400] as part of the stage 2 
VBLANK process. 


P23 SDLSTL# €60230,1] and SDLSTH# (0231,1] -- Display list address 


The Display Handler formats a new display list with every OPEN 
command and puts the display list address in SDLSTL and SDLSTH. The 
value of these bytes are stored to DLISTL €D402] and DLISTH [D403] 
as part of the stage 2 VBLANK process. 


0360-O036F IOCB #2 
0370-037F IOCB #3 
0380-O35F IOCB #4 
0390-O39F IOCB #5 
O3AG-O3AF IOCB #6 
OSBO-O3BF IOCB #7 
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NOTE: There is a potential timing problem associated with the 
updating of the hardware registers from the data base variables. 
Since the stage 2 VBLANK process is performed with interrupts 
enabled, it is possible for an IR@ interrupt to occur before the 
updating of DLISTH and DLISTL. If the processing of that 
interrupt (plus other nested interrupts) exceeds the 
vertical-blank delay (1 msec), then the display list pointer 
register will not have been updated when display list processing 
commences for the new frame. and a screen glitch will result. 


P24 GPRIOR* CO26F,.11] -- Priority control 

The Display Handler alters bits & and 7 of GPRIOR as part of 
establishing the GTIA mode. The value of GPRIOR is stored to 
PRIOR CDO1IBIJ as part of the stage 2 VBLANK process. 

P25 CHACT# CO2F3,1] -- Character control 

The Display Handler sets CHACT to $02 on every OPEN command. The 
value of CHACT is stored to CHACTL (D401] as part of the stage 2 
VBLANK process. 

P26 CHBAS (O02F4,1] -- Character address base 

The Display Handler sets CHBAS to $E0O on every OPEN command. The 
value of CHBAS is stored to CHBASE [D409] as part of the stage 2 
VBLANK process. This variable controls the character subset for 
screen modes 1 and 2; a value of $EO provides the capital letters 
and number set whereas a value of $E2 provides the lowercase 
letters and special graphics set. See BSS for more information. 


P27 PCOLRx £02C0,4] and COLORx (02C4,5] -- Color registers 


See B7 and BS. 


Internal Working Variables 


P28 INTEMP* [O22D,11] -- Temporary storage 


INTEMP is used by the SETVBL (SETVBV) routine. 
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R. USER AREAS 
The areas shown below are available to the user in a non-nested 
environment. See Section 4 for further information. 


Ri C0080. 128] 


R2 C0460, 640] 
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ALPHABETICAL LIST OF DATA BASE VARIABLES 


NAME. 


ADDCOR 
ADRESS 
APPMHI 
ATACHR 
ATRACT 


BFENHI 
BFENLO 
BITMSK 
BLIM 
BOOT? 
BOOTAD 
BOTSCR 
BPTR 
BRKKEY 
BUFADR 
BUFCNT 
BUFRFL 
BUFRHI 
BUFRLO 
BUFSTR 


CASBUF 
CASFLG 
CASINI 
CASSBT 
CAUX1 

CAUX2 

CBAUDH 
CBAUDL 
CCOMND 
CDEVIC 
CDTMAi 
CDTMA2 
CDTIMFS3 
CDTMF4 
CDTMFS 
CDOTMV1 
CDTMV2 
CDTMV3 


VID 
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ADDRESS SIZE 


OS3OE, i 
0064, 2 
OGOE, 2 
O2FB, 1 
O004D, 1 


0035, 1 
0034, 1 
OOGE, 1 
QO28A, 1 
0009, 1 
0242, 2 
O2BF, 1 
OOSD, i 
0011,1 
0015,2 
OOGB, 1 
0038, 1 
0033, 1 
0032, 1 
006C, 2 


OSFD, 131 


OSOF, 1 
0002, 2 
OO4B, 1 
O23C,1 
O23D, i 
O2EF, 1 
O2EE, 1 
O23B, 1 
O23A, 1 
0226, 2 
0228, 2 
022A, 1 
022C,1 
O22E,1 
0226, 2 
O21A,2 
021C,2 


CDTMV4 
CDTMVS 
CH 
CHASNT 
CH1 
CHACT 
CHAR 
CHBAS 
CHKSNT 
CHKSUM 
CIOCHR 
CcIx 
CKEY 
COLAC 
COLCRS 
COLDST 
COLINC 
COLORO 
COLOR1 
COLOR2 
COLORS 
COLOR4 
COLRSH 
COUNTR 
CRETRY 
CRITIC 
CRSINH 
CSTAT 


DAUX1 
DAUX2 . 
DBSECT 
DBUFHI 
DBUFLO 
DBYTHI 
DBYTLO 
DCB 
DCOMND 
DDEVIC 
DEGFLG 
DEL TAC 
DEL TAR 
DFLAGS 
DIGRT 
DINDEX 
DMASK 
BOSINI 
DOSVEC 
DRETRY 
BRKMSK 
DSKTIM 
DSKUTL 
DSPFLG 
DSTAT 
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BS, P27 
Bil 
B23 
Hil 


B27 
B34 
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O21E, 2 
0220, 2 
O2FC, i 
OO0O3B, i 
O2F2, 1 
O2F 3, 1 
O2FA, i 
O2F 4, 1 
OOSB, 1 
0031, 1 
CO02F, i 
OOF 2, 1 
OO4A, 1 
0072, 2 
0055, 2 
0244, 1 
OO7A: 1. 
02C4, I 
O02C5, 1 
02C6, 1 
O02C7, 1 
02CcSs, 1 
OO4F, 1 
OO7E, 2 
0036, i 
0042, i 
O2FO, 1 
0288, i 


O3OA, 1 
O3OB, 2 
0241,1 
0304, 1 
0305, 1 
0308, i 
0309, 1 
0300, 12 
0302; 1 
0300, 1 
OOFEB, 1 
0077, 2 
0074, 1 
0240, 1 
OOF i, i 
0057, 1 
O2A0, 1 
o00c, 2 
OOOA, 2 
0037, 1 
OO4E, 1 
0246, 1 
OO1A, 2 
O2FE, 1 
004C, 1 


DSTATS 
DTIMLO 
DUNIT 

DUNUSE 
DVSTAT 


EE XP 
ENDPT 
ERRFLG 
(ERRNO 
ESCFLG 
ESIGN 


FCHRFL 
FEOF 
FILDAT 
FILFLG 
FLPTR 
FMSZPG 
FPSCR 
FPSCRi 
FPTR2 
FRO 
FRi 
FR2 
FRE 
FREG 
FRMADR 
FRX 
FSCR 
FSCR1i 
FTYPE 


GPRIOR 


HATABS 
HOLD1 
HOLD2 
HOLDS 
HOLD4 
HOLDCH 


ICAX1 
ICAX12Z 
ICAX2 
ICAX2Z 
ICBAH 
ICBAHZ 
ICBAL. 
ICBAL.Z 
ICBLH 
ICBLHZ 
ICBLL 
ICBLLZ 
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0303, 1 
0306, 1 
0301, 1 
0307, 1 
O2EA, 4 


OOED, 1 
0074,2 
O23F, 1 
0049, 1 
O2A2, 1 
OOEF, 1 


OOFO, 1 
OOSF, 1 
O2FD, 1 
02B7,1 
OOFC, 2 
0043, 7 
OSEG, & 
OSEC, 6 
OOFE, 2 
OOD4, & 
OOEO, 6 
OGEG, & 
OODA, 6 
0040, 1 
0068, 2 
OOEC, 1 
OSEG, 6 
OSEC, 6 
OOSE, 1 


O26F, 1 


0314. 38 
0051,1 
O29F, 1 
O29D, 1 
O2BC, i 
CO7C, 1 


O34A, 1 
OO2A, 1 
O34B, 1 
OO2B, i 
0345, 1 
0025, i 
0024, 1 
0349, 1 
0029, 1 
0348, 1 
0028, 1 


ICCOM G4 | 0342, 1 


ICCOMT G23 0017.1 
ICCOMZ G16 0022, 1 
ICDNO G3 0341.1 
ICDNOZ G15 0021, 1 
ICHID G2 0340, 1 
ICHIDZ G14 0020, 1 
ICIDNO G24, G2 2002E, i 
ICPTH G7 0347,1 
ICPTHZ G19 0027, 1 
ICPTL. G7 0346, 1 
ICPTLZ G19 0026, 1 
ICSPR | G10 034C, 4 
ICSPRZ G22 002C,4 
ICSTA GS 0343, 1 
ICSTAZ G17 0023, 1 
INBUFF Mi2 OOF 3, 2 
INSDAT B45 007D, 1 
INTEMP P28 O22D, 1 
INVFLG ES O2B4, 1 
IOcB Gi 0340, 16 
TOCBAS G13 0020,14 
KEYDEL E2 O2F 1,1 
LBFEND M20 0580, 94 
LBPR1 M18 OS7E, 1 
LBPR2 M19 OS7F,1 
LBUFF M20 OS80, 96 
LINBUF BS1 0247, 46 
LMARGN BS 0052, 1 
LOGCOL. B1S 0062, 1 
LOGMAP B14 O2B2, 4 
MEMLO Al O2E7,2 
MEMTOP A2 O2ES, 2 
MLTTMP B40 0066, 2 
NEWCOL Big? 0061,2 
NEWROW B19 0040, 1 
NOCKSM H1S O0O3C, 1 
NSIGN M7 OOEE, 1 
OL.DADR B38 OOSE, 2 
OLDCHR B37 OOSD, 1 
OLDCOL BS COSB, 2 
OL.DROW B3 OOSA, 1 
OPNTMP B40 0066, 2 
PADDLO J 0270, 1 
PADDL1 JS 0271, 1 
PADDL2 JS 0272, 1 
PADDLS Jo 0273, 1 
PADDL4 J3 0274, 1 
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PADDLS 
PADDL6 
PADDL?7 
PBPNT 

PBUFSZ 
PCOLRO 
PCOLRi 
PCOLR2 
PCOLR3 
PLYARG 
POKMSK 
PRNBUF 
PTEMP 

PTIMOT 
PTRIGO 
PTRIGi 
PTRIG2 
PTRIGS 
PTRIG4 
PTRIGS 
PTRIG6 
PTRIG7 


RADFLG 
RAMLO 

RAMSI2Z 
RAMTOP 
RECVDN 
RMARGN 
ROWAC 

ROWCRS 
ROWINC 
RTCLOK 


SAVADR 
SAVIO 
SAVMSC 
SCRFLG 
SDLSTH 
SDLSTL. 
SDMCTL 
SHF AMT 
SHFLOK 
SOUNDR 
SRTIMR 
SSFLAG 
SSKCTL 
STACKP 
STATUS 
STICKO 
STICKi 
STICK2 
STICKS 
STRIGO 


ua 
Ja 
J3 
Fa 
F2 
B7, P27 
B7, P27 
B7, P27 
B7, P27 
M21 
P2 
Fi 
F4 
FS 
J4 
J4 
J4 
J4 


0275, 1 
0276, 1 
0277, 1 
OG1D. 1 
OO1E, 1 
02CO, 1 
O2Ci, 1 
02C2, 1 
02C3, 1 
OSEO, & 
0010, i 
O3C0, 40 
OO1F,1 
OG1C, i 
027C, 1 
O27D, 1 
O27E, 1 
O27F, 1 
0280, 1 
0281, 1 
0282. 1 
0283, 1 


H31 

Ji, J7, JS 
Ji, J7, JS 
Ji, U7, JB 
Ji, J7, J8 
Ja, J7, JSP 
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OOFB, 1 
0004, 3 
O2E4, 1 
OOGA, 1 
0039, 1 
OO0S3, t 
0070, 2 
0054, i 
0079, 1 
0012.3 


0048, 2 
0316, 1 
0058. 2 
O2BB, 1 
O0231,1 
0230, 1 
O22F, 1 
OOGF, 1 
O2BE, 1 
0041, 1 
O22B, 1 
O2FF, 1 
0232, 1 
0318, 1 
0030, 1 
0278, 1 
0279, 1 
O27A, 1 
O27B, 1 
0284, 1 


STRIG1 Ja, 7, SP 02835, 1 


STRIG2 das J7, SD 0286, 1 
STRIGS Ja, J7, SP 0284, 4 
SUB TMP B48 O29E, 1 
SWPFLG B44 007B, 1 
TABMAP B13 O2A3,15 
TEMP H23 O23E, 1 
TEMP 1 DS O312,2 
TEMPS DG O315, 1 
TIMER1 D3 O30C, 2 
TIMER2 DS 0310,2 
TIMFLG D2, H25 0317, 1 
TINDEX B4a9 0293. 1 
TMPCHR B33 0050, 1 
TMP COL B46 02B9, 2 
TMPLBET B47 O2A1, 1 
TMPROW B44 O2BS, 1 
TOADR B40 0066, 2 
TRAMSZ Ni 0004, 3 
TSTAT H29 0319, 1 
TSTDAT N2 0007, 1 
TXTCOL B4 0291.2 
TXTMSC BS2 0294, 2 
TXTOLD BS3 0296, 6 
TXTROW B4 0290, 1 
USAREA Ri 0080, 128 
VBREAK P1ié 02064, 2 
VDSLST Pid 0200, 2 
VIMIRG P13 0216, 2. 
VINTER P15 0204, 2 
VKEYBD P17 0208, 2 
VPRCED P14 0202, 2 
VSERIN P18 020A, 2 
VSEROC P20 O20E. 2 
VSEROR P19 020C,.2 
VTIMR1 P21 0210, 2 
VTIMR2 P2i O212. 2 
VTIMR4 P21 0214,2 
VVBLKD Pi2 0224.2 
VVBLKI Pil 0222. 2 
WARMST N13 0008, 1 
WMODE D1i4 0289, 1 
XMTDON H24 OO3A, 1 
(ZBUFF Ke > 0043, 2 
(ZDRVA K3> 0045, 2 
ZIOCB Gi3 0020, 16 
(ZSBA K4) 0047,2 
ZTEMP 1 M13 OOFS. 2 
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ZTEMPS M15 OOF9, 2 
ZTEMP4 M14 OOF 7,2 
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MEMORY ADDRESS ORDERED LIST OF DATABASE VARIABLES 


ADDRESS 


0000-0001 
0002-0003 
0004-0006 
0007 
0008 
0009 
QO0A-O0OB 
000C-O000D 
COOE-OOOF 
0010 
oo11 
0012-0014 
0015-0016 
0017 
001A-001B 
OO1C 
001D 
OO1E 
OO1F 
0020 
0021 
0022 
0023 
0024-0025 
0026-0027 
— 0028-0029 
002A-002B 
002C ~O02F 
Q030 
0031 
0032-0033 
0034-0035 
0036 
0037 
0038 
0039 
OCO3A 
003B 
003C 
003D 
COSE 
OO3F 
0040 
0041 
0042 
0043-0049 
004A 
004B 
004c 
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VID NAME 

$7 LNZBS 

N6 CASINI 

Ni RAMLO, TRAMSZ 
N2 TSTDAT 

Nis WARMST 

N7 BOOT? 

Ni2 DOSVEC 

NS DOSINI 

AS APPMHI 

P2 POKMSK 

ES BRKKEY 

PS RTCLOK 

Cl BUF ADR 

G23 ICCOMT 

Li DSKUTL 

FS PTIMOT 

FS PBPNT 

Fe PBUFSZ 

F4 P TEMP 

G13, G14 ICHIDZ 

G15 ICDNOZ 

G16 ICCcOMZ 

G17 ICOBAS 

G18 ICBALZ, ICBAHZ 
G19 ICPTLZ, ICPTHZ 
G20 ICBLLZ, ICBLHZ 
G2i ICAX1Z, ICAX2Z 
G22, 624,625 ICSPRZ 

H3i STATUS 

His CHKSUM 

H16 BUFRLO, BUFFRHI 
H17 BFENLO, BFENHI 
Hil CRETRY 

Hi2 DRETRY 

H2i BUFRFL. 

H22 RECVDN 

H24 XMTDON 

H1i4 CHKSNT 

HiS NOCKSM 

Dil BPTR 

D1i3 FTYPE 

Di2 FEOF 

Bis FREQ 

H1iO SOUNDR 

Pi CRITIC 

Kil, K2, KS, K4, KS ZBUFF, ZBUFP, ZDRVA, ZSBA 
N4 CKEY 

NS CASSBT 

B34 DSTAT 
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004D 
OCO4E 
OO4F 
0050 
0051 
0052 
0053 
0054-0056 
0057 
0058-0059 
OOSA-OCSC 
OOSD 
QOOSE-OCSF 
0060-0062 
0063 
0064-0065 
0066-0067 
0068-0049 
O06A 
OO4B 
006C-006D 
OO6E 
OO6F 
0070-0073 
0074-0075 
0076-60078 
0079-CO07A 
0078 
007C 
007D 
O0O7E-O007F 


0080-O0FF 
0100-O1FF 


0200-0201 
0202-6203 
0204-0205 
0206-0267 
0208-0209 
O020A-O020B 
020C-02CB 
O020E-C20F 
0210-0215 
0216-0217 
0218-0219 
021A-021B 
021C-0221 
0222-0223 
0224-0225 
0226-0227 
0228-0229 
022A 


B10 
Bi2 
Bil 
B33 
B30 
BS 

Bé 

B2 

B35 
B36 
B3 

B37 
B38 
Bi? 
BiS 
B39 
B40 
B4i 
A4 

B42 
B43 
BSO 
B2? 
B24 
Bes 
Bae 
B21 
B44 
E7 

B45 
B23 


SEE FLOATING 


6502 STACK 


P10 
Pi4 
P15 
P16 
P17 
P18 
P19 
P20 
P21 
P13 
P4,H26 
P& 
Pe 
Pil 
P12 
PS, H27 
P7 
P9 


ATRACT 
DRKMSK 
COLRSH 
TMPCHR 
HOLD1 

LMARGN 
RMARGN 


ROWCRS, COLCRS 


DINDEX 
SAVMSC 


OLDROW, OLDCOL 


OLDCHR 
OLDADR 


NEWROW, NEWCOL 


LOGCOL 
ADRESS 


MLTTMP,. OPNTMP, TOADR 
SAVADR /FRMADR 


RAMTOP 
BUFCNT 
BUFSTR 
BITMSK 
SHF AMT 


ROWAC, COLAC 


ENDPT 


DELTAR, DELTAC 
ROWINC, COLINC 


SWPFLG 
HOLDCH 
INSDAT 
COUNTR 


POINT VARIABLE LIST AT END. 


VDSLST 
VPRCED 
VINTER 
VBREAK 
VKEYBD 
VSERIN 
VSEROR 
VSEROC 


VITMR1. VITMR2, VITMR4 


VIMIRG 
CDTMV1 
CDTMV2 


CDTMVs, CDTMV4, CDTMVS 


VVBLKI 
VVBLKD 
CDTMAL 
CDTMA2 
CDTMF3 
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022B 
022C 
022D 
O22E 
022F 
0230-0231 
0232 
023A 
0293B 
023C-023D 
O23E 
023F 
0240 
0241 
0242-0243 
0244 
0246 
024-7-026E 
O24F 
0270-0277 
0278-027B 
027C-0283 
0284-0287 
0289 
OC28A 


O28B-O2EF . 


0290-0292 
0293 
0294-0295 
0296-0298 
029D 

029E 

029F 

02A0 

O2Al 

02A2 
O2A3~-02B1 
O2B2-02B5 
O2B6 

02B7 
O2B8-O02BA 
O2BB 

O2BC 

O2BE 

O2BF 
02C0-02C3 
020 4-02C8 
O2E4 
O2ES-O2E6 
02E7-02E8 
O2EA~-O2ED 
QO2EE-O2EF 
O2FO > 
02F 1 


268 


Ee 
Pg 
P28 
P9 
P22 
P23 
H32 
Hig 
H1i9 
H20 
H23 
H30 
Ne 
No 
N10 
Nii 
c2 
BS1 
P24 
J3 
J1,J7, J8 
J4 
J2, U7, JP 
D14 
D10 
S10 
B4 
B49 
B52 
B53 
B32 
B48 
B31 
B28 
B47 
B24 


Bié 
B7, P27 
BE, P27 
AS 

A2 

Al 

Gli 

D1 

Bi 

E2 
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SRTIMR 
CDTMF4 
INTEMP 
CBTMFS 
SDMCTL. 


SDLSTL, SDLSTH 


SSKCTL 
CDEVIC 
CCOMND 


CAUX1, CAUX2 


TEMP 
ERRFLG 
DFLAGS 


BOOTAD 
COLDST 
DSKTIM 


| DBSECT 


LINBUF 


GPRIOR 
PADDLO 
STICKO 
PTRIGO 
STRIGO 
WMODE 
BLIM 
unused 


TINDEX 
TXTMSC 
TXTOLD 
HOLDS 

SUBTMP 
HOLD2 

BMASK 

TMPLET 
ESCFLG 
TABMAP 
LOGMAP 
INVFLG 
FILFLG 


—~ PADDL7 
~~ STICKS 
~~ PTRIG7 
~~ STRIGS 


TXTROW, TXTCOL 


TMPROW, TMPCOL 


SCRFLG 
HOLD4 

SHFLOK 
BOTSCR 
PCOLRO 
PCOLRO 
RAMSIZ 
MEMTOP 
MEML.O 

DVSTAT 


-- PCOLRS 
~~ PCOLR4 


CHBAUDL, CHBAUDH 


CRSINH 
KEYDEL 


O02F2 
O2F3 
O2F4 
O2FA 
O2FB 
O2FC 
O2FD 
O2@FE 
O2FF 


0300 
0301 
0302 
0303 
0304-0305 
0306 
0308-0309 
O30A-030B 
O030C-O030D 
O3SO0E 
OSOF 
0310-0311 
0312-0313 
0315 
0316 
0317 
0318 
0319 
O31A-O33F 
0340 
0341 
0342 
0343 
0344-0345 


0346-0347 
0348-0349 
034A-034B 
034C~-O34F 
0350-035F 
0360-036F 
0370-037F 
0380-038F 
0390-039F 
O3A0-O34F 
O3B0-O3BF 
03C0-03E7 


OSFD~-0O47F 


0480-O04FF 


Ei 
P25 
P26 
BSS 
BS4 
ES 
B17 
B27 
E4 


Hi, H2 
HS 

H4 

HS 

H& 

H7 

H8 

HO 

D3 

D4 
DS 

D3 

DS 

D& 

D7 
D2, H2S 
H28 
H2? 
Gi2 
Gi, G2 
G3 

G4 

GS 

G4 


G7 

G8 

G9 

G10 
G2-G10 
G2-G10 
G2-G1i0 
G2-G10 
G2-G10 
G2-G10 
G2-G10 
Fi 


D9? 


R2 


FILDAT 
DSPFLG 
SSFLAG 


DCB/DDEVIC 
DUNIT 

DCOMND 
DSTATS 
DBUFLO, DBUFHI 
DTIMLO 
DBYTLO, DBYTHI 
DAUX1, DAUX2 
TIMER1 

ADDCOR 
CASFLG 
TIMER2 

TEMP 1 

TEMP3 

SAVIO 

TIMFLG 
STACKP 

TSTAT 

HATABS 

IOCB, ICHID 
ICDNO 

ICCOM 

ICSTA 

ICBAL, ICBAH 


ICPTL. ICPTH 
ICBLL, ICBLH 
ICAX1, ICAX2 
ICSPR 
(I1OCB #1} 
(IOCB #2} 
(IOCB #3) 
(IOCB #4} 
(I1O0CB #5) 
(IOCB #4) 
(IOCB #7) 
PRNBUF 


CASBUF 


User Area 
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FLOATING POINT PACKAGE VARIABLES 


00D4-00D9 
OODA~-OODF 
OOEO-O0ES 
OOE6-O0EB 
QOEC 
OOED 
OOEE 
OQOEF 
OOFO 
OOF 1 
OOF2 
OOF 3—-O0F 4 
OOF S-OOF6 
OOF 7-O0F8 
OOF9-OOFA 
OOFB 
OOF C~-OOFD 
OOFE-OOFF 


OS7E 
OS7F 
0S80-O5FF 
OSEO-OSES 
CSE6-OS5EB 
OSEC-OSF 1 
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FRO 

FRE 

FR1 

FR2 

FRX 
EEXP 
NSIGN 
ESIGN 
FCHRFLG 
DIGRT 
cIXx 
INBUFF 
ZTEMP1 
ZTEMP4 
ZTEMPS3 
RADFLG/DEGFLG 
FLPTR 
FPTR2 


LBPRi 

LBPR2 
LBFEND, LBUFF 
PLYARG 
FPSCR/FSCR 
FPSCR1/SCRi 
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INDEX 


The subyect index contains three forms of references: 


Section number, 


Appendix, such as ‘App B‘ 


Variable ID from Appendix L, 


ATARI standards 
ATASCII 
attract mode 


bit mapped graphics 
blackboard mode 

BNF 

boot 

BREAK 


cartridge 

cassette baud rate determine 
cassette-boot 

cassette device 

Cassette Handler (C) 

CIO (Central 1/0 Utility) 
CiO/user interface 
CiO/Handler interface 
CLOSE I/0 command 
coldstart (see ‘Power-up ’) 
color control 

control characters 
critical section 

cursor 


database 

DCB (Device Control Block) 
DELETE 1/0 command 
development system 


device/filename specification 


Device Handler 

device table 

disk-boot 

disk device 

Disk File Manager (D} 
Disk Handler (resident) 
display device (screen) 
Display Handler (S) 
display list 

DOS (Disk Utilities) 
DRAW 1/0 command 
driving controller 


Such as ‘3G. 


ce 


such as ’B7’. 


12 
BS4-55, 5, 
Bi0—-12, 4G, 


App D-G 


B28-B29, 5S, App H 

3, Ni2, 7, 12 

i 

3, 4, N3-10, 5S, 7, 10 
ES, & 12 


3 4 7, 10 
D1-D7 

3, NG-10, 7, 10 
D1-D1iS. 3. §$ 

3 

Gi-25, 5 9 | 
Gi-il, 5, App A. 
Gi2-22, 9 

3 9 


App B 


B7-8, eM & 
B26-27, 5S, 
Pi, & 
Bi-4, +) 


App DB 


4 

Hi-9, 5S. ? 

te) 

13 

te) 

2. 9 

2, Gia. & 7%. F 
3, N3-10, 5, 7 10 
2 

Ki-S, 5 
Ci-2, 5 
BS4-55, 5S. 
B1-55, S$ 
4, Pid 
Li, i2 
Bi7-25, 5 
J8-9 


App &, App H 


Educational System Format Cassettes 5 


error handling 


G5, HS, Hii-12,. 9, 
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App B-C 


EDF (end-of-file) > 


File Management System | 3 

FILL I/0 command Bi7-25, § 

floating point package 2, 4, Mi-24, 8 App J 
FORMAT 1/70 command be 

free memory 4, Ai~3, Ri-2, 4 7 
game controllers 3, Ji-9, & 11 

GET CHARACTER I/0 command 5, 9 

GET RECORD 1/0 command 3, 9 

GET STATUS 1/0 command Gil, & 9 


Handler (see ‘device handler’ and individual device handlers) 


initialization. cartridge 7 
initialization, Handler 7:1 > 
initialization. interrupt & 
initialization. system 4, 7, 10 
internal display code 5S, BS4 
interrupts 2, Pi-2e, 6 
interrupt mask P2, & 
inverse video (display? E?, 3 

1/0 2a 4 3 9 
IOCB (1/0 Control Block) Gi-10. 5, ¢? 
I/O retry logic Hii-i2 
pgoystick Ji-2 
keyboard Autorepeat E8 

keyboard device 3 

Keyboard Handler (K) E1i-?, 3, App F 
keyboard key debouncing E1i-3 

light pen ii, App J 
LNBUG 13 

LOCK I/0 command 2 


logical text lines (screen) Bi4-15, § 


memory (see ‘RAM’, ‘ROM’ and ‘free memory‘) 


memory dynamics Ail-S. Ni-2, 4, 3S. 7 
memory map 4 

NOTE 1/0 command 5 

OPEN 1/0 command 5, 9 

paddle Ja-4- - | 
page 0 4, Mi-17, Ri. 9 
page 1 4, 9 

peripheral devices 3 

POINT I/0 command 5 ; | 
Power-up 2, Ni-13, 4, 7 12 
printer device 3, App G 


OPERATING SYSTEM C016555 -—=— INDEX 
272 


Printer Handler (P) 
program development 

PUT CHARACTER I/0 command 
PUT RECORD I/0 command 


RAM 

record (1I/0} 

RENAME I/0 command 
RESET 

ROM (O0S} 

RS-232-C Handler (R? 


Screen Editor (&) 
screen margins 
screen modes 
scrolling (text) 
serial I/0 bus 
CSHIFTI/CONTROL lock 


SIO (Serial bus I/0 Utility? 


sound control (SIQ> 
SPECIAL I/70 commands 
split screen 

stack 

start/stop (display) 
stage 1 VBLANK process 
stage 2 VBLANK process 


tabs (Screen Editor) 
timeout (device?) 
timers (system} 


UNLOCK 1/0 command 
user workspace 


vectors, RAM 
vectors, ROM 
vertical blank interrupt 


warmstart (see ‘RESET’ } 
wild-card (disk filename) 


ZIOCB (Zero-page IOCB) 


2) Ni-is, &, 71 i2 


H1-32, Pi3-21, 3. 9, App C 
H1iO, 11 

9 

B1ié, 5S 

4 

E4, 5, 12 

P3-5, & 

P6-9, P22-27, & 


B13, 5S 
H25-27, 9 
P3-9, & 


-) 
4, M1i8-23, Re 


PS, P7, P10-21, &, 9 
5, 9, App J 

Pii-i2, & 

 ] 


Gi3-22, 9% 0020, 16 
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ATTN QI°400/800" 


ATARI HOME COMPUTER SYSTEM 


OPERATING SYSTEM 
SOURCE LISTING 


0) 
ATARI A Warner Communications Company ® 


COPYRIGHT 1982, ATARI, INC. 
ALL RIGHTS RESERVED 


TO ALL PERSONS RECEIVING THIS DOCUMENT 


Reproduction is forbidden without the specific written permission of 
ATARI, INC. Sunnyvale, CA 94086. No right to reproduce this document, 
nor the subject matter thereof, is granted unless by written agreement with, 
or written permission from the Corporation. 


Every effort has been made to ensure that this manual accurately 
documents this product of the ATARI Home Computer Division. 
However, due to the ongoing improvement and update of the computer 
software and hardware, ATARI, INC. cannot guarantee the accuracy 
of printed material after the date of publication and disclaims 
liability for changes, errors, or omissions. 


ERR LINE 


SONG GOAN 


ADDR Bi Be BS B4 


L 


ee ee et 
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Ist x 

THIS IS THE MODIFIED SEPTEMBER ATARI 400/800 COMPUTER OPERATING 
SYSTEM LISTING. MODIFIED TO ASSEMBLE ON THE MICROTEC CROSS 
ASSEMBLER. 

THIS VERSION IS THE ONE WHICH WAS BURNED INTO ROM. 

THERE IS A RESIDUAL PIECE OF CODE WHICH IS FOR LNBUG. THIS 

IS AT LOCATION $9C00 WHICH IS NOT IN ROM. 


THIS IS THE REVISION B EPROM VERSION 


i 


ERR LINE 


ADDR 


0000 


E400 
E410 
E420 
E430 
E440 


Bi Be BS B4 


a § a a 


ALFLG 


. 


a ee et 


CHRORG 
VECTBL 
VC TABL. 
CIOORG 
INTORG 
SIOORG 
DSKORG 
PRNORG 
CASORG 
MONORG 
KBDORG 


‘ 


Se eT) 


i HANDL. 
; TABLE 


~ 


we New 


i EXAMP 


m 


ee ee ee ee eT oe ee od 


EDITRV 
SCRENV 
KEYBDV 
PRINTV 
CASETV 


f 


i 


i THE F 
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. PAGE 


COLLEEN OPERATING SYSTEM EQUATE FILE- 
NTSC/PAL ASSEMBLY FLAG 


= 0 iQ = NTSC 1 = PAL 


MODULE ORIGIN TABLE 


= SEO00O i CHARACTER SET 

= $E400 iVECTOR TABLE 

= SE460 iRAM VECTOR INITIAL VALUE TABLE 
= SE4A6 i CENTRAL I/0 HANDLER 

= $E6DS i INTERRUPT HANDLER) 

= $SE944 i SERIAL 1/70 DRIVER 

= SEDEA i DISK HANDLER 

= SEE78 iPRINTER HANDLER 

= SEF 41 i CASSETTE HANDLER 

= $FOES iMONITOR/POWER UP MODULE 
= $FSE4 i KEYBOARD/DISPLAY HANDLER 


VECTOR TABLE 


ER ENTRY POINTS ARE CALLED OUT IN THE FOLLOWING VECTOR 
. THESE ARE THE ADDRESSES MINUS ONE. 
LE FOR EDITOR 
400 OPEN 

2 CLOSE 

4 GET 

& PUT 

8 STATUS 

A SPEC TAL 

C JUMP TO POWER ON INITIALIZATION ROUTINE 
»F NOT USED 

= $E400 i EDITOR 

= $E410 i TELEVISION SCREEN 

= FE 420 i KEYBOARD 

= $E430 i PRINTER 

= $E440 i CASSETTE 


JUMP VECTOR TABLE 


OLLOWING IS A TABLE OF JUMP INSTRUCTIONS 


ERR LINE 


ADDR 


0003 
0005 
0007 
0009 
OCOB 
O00C 
OCOD 
O0OE 


0011 
0012 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
OOFF 


0001 
0002 
0004 
0008 
000c 
0010 
0020 


Bi B2 BS B4 


i TO VARIOUS ENTRY POINTS IN 


DISKIV 
DSKINV 
croav 

Sr1ov 

SETVBYV 
SYSVBV 
XITVBV 
SIOINV 
SENDEV 
INTINV 
CIOINV 
BLKBDV 
WARMSV 
COLDSV 
RBLOKV 
CSOPIV 
i VCTABL 


i 


a eT) 


tut ibtit tank ban en ot 
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$E480 


THE OPERATING SYSTEM. 


SE450 iDISK INITIALIZATION 

$E453 iDISK INTERFACE 

$E456 i CENTRAL INPUT QUTPUT ROUTINE 

SE459 iSERIAL INPUT OUTPUT ROUTINE 

SE45C iSET SYSTEM TIMERS ROUTINE 

$E4S5F i SYSTEM VERTICAL BLANK CALCULATIONS 
SE462 i EXIT VERTICAL BLANK CALCULATIONS 
SE465 iSERIAL INPUT OUTPUT INITIALIZATION 
$E468 i SEND ENABLE ROUTINE 

SE46B i INTERRUPT HANDLER INITIALIZATION 
SE46E i CENTRAL INPUT OUTPUT INITIALIZATION 
$E471 i BLACKBOARD MODE 

SE474 iWARM START ENTRY POINT 

$E477 iCOLD START ENTRY POINT 

SE47A i CASSETTE READ BLOCK ENTRY POINT VECTOR 


$E47D i CASSETTE OPEN FOR INPUT VECTOR 


OPERATING SYSTEM EQUATES 


i COMMAND CODES FOR IOCB 


OPEN 
GETREC 
GETCHR 
PUTREC 
PUTCHR 
CLOSE 
STATIS 
SPECIL 


a 


" 


Hubb wou 


i SPECIAL ENTRY 


DRAWLN 
FILLIN 
RENAME 
DELETE 
FORMAT 
LOCKFL 
UNLOCK 
POINT 
NOTE 
IOCFRE 


‘ 


Haku bt eo uw won a 


i AUX EQUATES 
i (2) INDICATES WHICH DEVICES USE BIT 


APPEND 
DIRECT 
OPNIN 

OPNOT 

OPNINO 
MXDMOD 
INSCLR 


pi wb dt won 


3 iOPEN FOR INPUT/OUTPUT 

3 iGET RECORD (TEXT> 

7 iGET CHARACTER(S) 

9? iPUT RECORD (TEXT> 

$B iPUT CHARACTER(S} 

$C i CLOSE DEVICE 

$D i STATUS REQUEST 

SE i BEGINNING OF SPECIAL ENTRY COMMANDS 
COMMANDS 

$il i DRAW LINE 

$12 i DRAW LINE WITH RIGHT FILL 
$20 iRENAME DISK FILE 

$21 iDELETE DISK FILE 

$22 i FORMAT 

$23 iLOCK FILE TO READ ONLY 
$24 i UNLOCK LOCKED FILE 

$25 iPOINT SECTOR 

$26 iNOTE SECTOR 

$FF iIOCB “FREE” 


$10 
$20 


i OPEN FOR WRITE APPEND (D), 


OR SCREEN READ ( 


i OPEN FOR DIRECTORY ACCESS (D) 
;OPEN FOR INPUT (ALL DEVICES} 
i OPEN FOR OUTPUT (ALL DEVICES) 
OPNIN+OPNOT i OPEN FOR INPUT AND OUTPUT (ALL DEVICES) 


i; OPEN FOR MIXED MODE (E,S) 


i OPEN WITHOUT CLEARING SCREEN (E,S>} 
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118 i 

119 + DEVICE NAMES 

12660045 SCREBDT = ‘'E i SCREEN EDITOR (R/W) 

12i O0O4B8 KBD = "K i KEYBOARD (R ONLY? 

122 0653 DISPLY = '§ i SCREEN DISPLAY (R/W) 

i123 0ooso PRINTR = Pp iPRINTER (W ONLY? 

124 0043 CASSET = ‘Cc i CASSETTE 

125 o004D MODEM = “mM i MODEM 

126 0044 DISK = ‘D i DISK (R/W) 

127 ; 

128 i SYSTEM EOL (CARRIAGE RETURN) 

i29 OO9B CR = $9B 

130 i 

131 i 

132 i OPERATING SYSTEM STATUS CODES 

133 i 

134 ooo1 SUCCES = $01 i SUCCESSFUL OPERATION 

135 i 

136 0080 BRKABT = $80 i BREAK KEY ABORT 

137 oOcsi PRVOPN = $81 i#IOCB ALREADY OPEN 

138 0082 NONBEV = $82 iNON-EXISTANT DEVICE 

139 0083 WRONLY = $83 iIOCB OPENED FOR WRITE ONLY 
140 0084 NVALID = $B4 i INVALID COMMAND 

141 ooB8s NOTOPN = $85 i DEVICE OR FILE NOT OPEN 

142 0086 BADIOC = $86 i INVALID IOCB NUMBER 

143 0087 RDONLY = $87 ;1OCB OPENED FOR READ ONLY 
144 008s EOFERR = $86 i END OF FILE 

145 o0o8s9 TRNRCD = $89 i TRUNCATED RECORD 

14& OOBA TIMOUT = sodA ;#PERIPHERAL DEVICE TIME OUT 
147 0OO8B DNACK = $8B *# DEVICE BOES NOT ACKNOWLEDGE COMMAND 
148 oosc FRMERR = $8C i SERIAL BUS FRAMING ERROR 
149 OOS8D CRSROR = $8b i CURSOR OVERRANGE 

150 OGOB8E OVRRUN = $8E ; SERIAL BUS DATA OVERRUN 

151 OO8F CHKERR = $6F ; SERIAL BUS CHECKSUM ERROR 
152 F 

153 0090 DERROR = $90 iPERIPHERAL DEVICE ERROR (OPERATION NOT COMP 
154 oo9! BADMOD = $91 i#BAD SCREEN MODE NUMBER 

i855 0092 FNCNOT = $92 i#FUNCTION NOT IMPLEMENTED IN HANDLER 
156 0093 SCRMEM = $93 i INSUFICIENT MEMORY FOR SCREEN MODE 
157 i 

158 i 

159 i 

140 i 

141 i 

162 i 

163 i PAGE ZERO RAM ASSIGNMENTS 

144 i 

165 #=$0000 

146 0000 LINZBS: .RES 2 iLINBUG RAM (WILL BE REPLACED BY MONITOR RAM 
147 i 

168 i THESE LOCATIONS ARE NOT CLEARED 

1649 0002 CASINI: . RES 2 i CASSETTE INIT LOCATION 

170 0004 RAMLO: . RES 2 +RAM POINTER FOR MEMORY TEST 


171 0006 TRAMSZ: .RES 1 i TEMPORARY REGISTER FOR RAM SIZE 
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172 0007 TSTDAT: .RES 1 iRAM TEST DATA REGISTER 

i723 F 

174 ; CLEARED ON COLDSTART ONLY 

175 0008 WARMST: .RES 1 i WARM START FLAG 

176 0O009 BOOT?: . RES 1 i SUCCESSFUL BOOT FLAG 

i177 OOCOA DOSVEC: .RES 2 i DISK SOFTWARE START VECTOR 

178 o00c DOSINI: .RES 2 i DISK SOFTWARE INIT ADDRESS 

179 OGOE APPMHI: . RES 2 i APPLICATIONS MEMORY HI LIMIT 

180 i 

181 i CLEARED ON COLD OR WARM START 

182 0010 INTZBS = i INTERRUPT HANDLER 

183 oo10 POKMSK: .RES 1 i SYSTEM MASK FOR POKEY IRQGQ ENABLE 
i184 oOoi1 BRAKEY: . RES i i BREAK KEY FLAG 

185 oocte RTCLOK: .RES 3 iREAL TIME CLOCK (CIN 16 MSEC UNITS} 
186 i 

i87 0015 BUFADR: .RES 2 i; INDIRECT BUFFER ADDRESS REGISTER 
188 F 

189 0017 ICCOMT: . RES 1 i COMMAND FOR VECTOR 

190 i 

191 OoO1s DSKFMS: .RES 2 i; DISK FILE MANAGER POINTER 

i92 OO1A DSKUTL: .RES 2 i DISK UTILITIES POINTER 

193 i 

194 O01C PTIMOT: . RES 1 iPRINTER TIME OUT REGISTER 

195 OO1D PBPNT: . RES 1 iPRINT BUFFER POINTER 

194 OG1E PBUFSZ: .RES 1 iPRINT BUFFER SIZE 

197 OO1F PTEMP: . RES 1 i TEMPORARY REGISTER 

198 i 

i979 0G20 ZIOCB = i ZERO PAGE 1/0 CONTROL BLOCK 

200 00106 IOCBSZ = 1& i; NUMBER OF BYTES PER IOCB 

201i 0080 MAXIOC = S8#IOCBSZ i LENGTH OF THE IOCB AREA 

202 0020 IOCBAS =+# 

203 06020 ICHIDZ: .RES i ;HANDLER INDEX NUMBER (FF = IOCB FREE} 
204 0021 ICDNOZ: .RES 1 i; DEVICE NUMBER (DRIVE NUMBER? 

205 0022 ICCOMZ: .RES 1 i COMMAND CODE 

206 0023 ICSTAZ: .RES 1 iSTATUS OF LAST IOCB ACTION 

207 06024 ICBALZ: .RES 1 ;BUFFER ADDRESS LOW BYTE 

208 00625 ICBAHZ: .RES 1 

209 0026 ICPTLZ: .RES 1 ;PUT BYTE ROUTINE ADDRESS — i 

210 0027 ICPTHZ: .RES i 

2iti oo2B ICBLLZ: .RES 1 i BUFFER LENGTH LOW BYTE 

2i2 0029 ICBLHZ: . RES 1 

213 OO02A ICAX1Z: .RES 1 ; AUXILIARY INFORMATION FIRST BYTE 
214 002B ICAX2Z: .RES i 

215 ©o02C ICSPRZ: , RES 4 ; TWO SPARE BYTES (CIO LOCAL USE) 
216 OO02E ICIDNO = ICSPRZ+2 i IOCB NUMBER X 14 

217 OG2F CIOCHR = ICSPRZ+3 i CHARACTER BYTE FOR CURRENT OPERATION 
218 ; 

219 ©0030 STATUS: .RES 1 ; INTERNAL STATUS STORAGE 

220 0031 CHKASUM: | RES 1 i; CHECKSUM (SINGLE BYTE SUM WITH CARRY)? 
221 0032 BUFRLO: .RES 1 ;POINTER TO DATA BUFFER (LO BYTE? 
222 0033 BUFRHI: .RES 1 iPOINTER TO DATA BUFFER (HI BYTE) 
223 0034 BFENLO: .RES i iNEXT BYTE PAST END OF THE DATA BUFFER (LO B 
224 06035 BFENHI: .RES 1 i;NEXT BYTE PAST END OF THE DATA BUFFER (HI B 
2253 (0036 CRETRY: . RES 1 aiNUMBER OF COMMAND FRAME RETRIES 


ERR LINE 


226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
259 
256 
257 
258 
259 
240 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
2739 
276 
277 
278 
279 


ADDR Bi Be BS B4 


0037 
0038 
0039 
003A 
O003B 
003C 


0O3D 
OO3SE 
003F 
0040 
0041 
0042 


0043 


0044 
004B 
004C 


004D 
OO4E 
OO4F 


0002 
0027 
0050 
0051 
0052 
0053 
0054 
0055 
0057 
0058 
OOSA 
O00OSB 
005D 
OOSE 
0060 
0061 
0043 
0064 
0066 
00646 
0068 
C064 
O04B 
006C 
OO6E 
OO4F 
0070 
0072 


DRETRY: 
BUFRFL: 
RECVDN: 
XMTDON: . 
CHKSNT: .. 
NOCKSM: 


4 


BPTR: 
FTYPE: 
FEOF: 
FREG: 


SOUNDR: 
CRITIC: 


FMSZPG: 


’ 


CKEY: 


CASSBT: 


DSTAT: 


ATRACT: 
DRKMSK: 
COLRSH: 


LEDGE 
REDGE 


TMPCHR: . 


HOLD1: 


LMARGN: 
RMARGN: 
ROWCRS: 
COLCRS: 
DINDEX: 
SAVMSC: 
OLBDROW: 
OLDBCOL: 
OLDCHR: 
OLDADR: 
NEWROW: 
NEWCOL: 
LOGCOL: 
ADRESS: 
MLTTMP: 


OPNTMP 


SAVADR: 
RAMTOP: 
BUFCNT: 
BUFSTR: 
BITMSK: 
SHFAMT: 


ROWAC: 
COLAC: 


. RES 


io 
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i i NUMBER OF DEVICE RETRIES 

1 i DATA BUFFER FULL FLAG 

1 iRECEIVE DONE FLAG 

1 i TRANSMISSION DONE FLAG 

1 i CHECKSUM SENT FLAG 

1 iNO CHECKSUM FOLLOWS DATA FLAG 

1 

1 

1 

1 

1 iNOISY I/0 FLAG. (ZERO IS QUIET) 

1 i; DEFINES CRITICAL SECTION (CRITICAL IF NON-Z 
7 iDISK FILE MANAGER SYSTEM ZERO PAGE 
1 iFLAG SET WHEN GAME START PRESSED 

1 iCASSETTE BOOT FLAG 

1 i DISPLAY STATUS 


i ATRACT FLAG 
i DARK ATRACT MASK 
i ATRACT COLOR SHIFTER (EOR‘ED WITH PLAYFIELD 


pe pe 


i LMARGN‘’S VALUE AT COLD START 
9? i RMARGN‘S VALUE AT COLD START 


i LEFT MARGIN (SET TO 1 AT POWER ON) 
iRIGHT MARGIN (SET TO 38 AT POWER ON> 
i CURSOR COUNTERS 


i DATA UNDER CURSOR 
;POINT DRAW GOES TO 


;POINTS AT COLUMN IN LOGICAL LINE 


LTTMP iFIRST BYTE IS USED IN OPEN AS TEMP 


;RAM SIZE DEFINED BY POWER ON LOGIC 
iBUFFER COUNT 

i;EDITOR GETCH POINTER 

iBIT MASK 


Pfr es Pee Me PR Re Re MD A ee ee OA) 
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280 0074 ENDPT: .RES 


2 
281 0076 DELTAR: .RES 1 
282 0077 DELTAC: .RES 2 
283 0079 ROWINC: .RES 1 
284 007A COLINC: .RES 1 
285 007B SWPFLG: .RES 1 iNON-O IF TXT AND REGULAR RAM IS SWAPPED 
284 007C HOLDCH: . RES 1 iCH IS MOVED HERE IN KGETCH BEFORE CNTL & SH 
287 007D INSDAT: .RES 1 
288 007E COUNTR: . RES 2 
289 i 
290 i 
291 i 
292 i 
293 i 80 - FF ARE RESERVED FOR USER APPLICATIONS 
294 i 
295 i 
296 i 
297 i NOTE : SEE FLOATING POINT SUBROUTINE AREA FOR ZERO PAGE CELLS 
298 i 
299 i 
300 i 
301 i 
302 i PAGE 1 = STACK 
303 i 
304 i 
305 i 
306 i 
307 i PAGE TWO RAM ASSIGNMENTS 
308 i 
309 #=$0200 
310 0200 INTABS =% i INTERRUPT RAM 
311 0200 VDSLST: .RES 2 i DISPLAY LIST NMI VECTOR 
312 0202 VPRCED: .RES 2 ;PROCEED LINE IRQ VECTOR 
313 0204 VINTER: . RES 2 i INTERRUPT LINE IRQ VECTOR 
314 0206 VBREAK: . RES 2 i SOFTWARE BREAK (00) INSTRUCTION IR@ VECTOR 
315 0208 VKEYBD: . RES r= iPOKEY KEYBOARD IRG VECTOR 
314 O20A VSERIN: . RES 2 i POKEY SERIAL INPUT READY IRQ 
317 O20C VSEROR: . RES 2 iPOKEY SERIAL OUTPUT READY IRQ 
318 O20E VSEROC: .RES 2 iPOKEY SERIAL OUTPUT COMPLETE IRQ 
319 0210 VTIMRi: . RES 2 iPOKEY TIMER 1 IRG 
320 O21l2 VTIMR2: . RES 2 *+POKEY TIMER 2 IRQ 
321i 0214 VTIMR4: |. RES 2 iPOKEY TIMER 4 IRG 
322 0216 VIMIRG: . RES e i IMMEDIATE IRQ VECTOR 
323 0218 CDTMVi: . RES 2 i COUNT DOWN TIMER 1 
324 O21A CDIMV2: . RES 2 i COUNT DOWN TIMER? 
325 O21C CDTMV3: .RES 2 i COUNT DOWN TIMER 3 
326 O2i1E CDTMV4: .RES 2 i COUNT DOWN TIMER 4 
327 0220 CDTMVS: .RES 2 i COUNT DOWN TIMER 5 
328 0222 VVBLKI: . RES 2 i; IMMEDIATE VERTICAL BLANK NMI VECTOR 
327? 0224 VVBLKD: .RES 2 i DEFERRED VERTICAL BLANK NMI VECTOR 
330 0226 CDTMA1: .RES 2 i COUNT DOWN TIMER 1 JSR ADDRESS 
331 0228 CDTMA2: . RES 2 i COUNT DOWN TIMER 2 JSR ADDRESS 
332 022A CDTMF3: .RES 1 i COUNT DOWN TIMER 3 FLAG 
333 0228 SRTIMR: . RES 1 i SOFTWARE REPEAT TIMER 


ERR LINE 


Bi 


Be BS B4 


CDIMF4: 
INTEMP: 
CDIMFS: 
SDMCTL: 
SDLSTL: 
SDBLSTH: 
SSKCTL: 


LPENH: 
LPENV: 
BRKKY: 


’ 


CDEVIC: 
CCOMND: 
CAUX1: 
CAUX2: 
i NOTE: 
TEMP : 
i NOTE: 
ERRFLG: 


DFLAGS: 
DBSECT: 
BOOTAD: 
COLDST: 


, 


DSKTIM: 
LINBUF: 
GPRIOR: 


PADDLO: 
PADDLI: 
PADDL2: 
PADDL3: 
PADDL&4: 
PADDLS: 
PADDLS: 
PADDL?7: 
STICKO: 
STICKL: 
STICK2: 
STICK: 
PTRIGO: 
PTRIGL: 
PTRIG2: 
PTRIG3: 
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. RES 3 i COUNT DOWN TIMER 4 FLAG 
. RES 1 i TAN’S TEMP (RENAMED FROM Ti BY POPULAR DEMA 
. RES 1 i COUNT DOWN TIMER FLAG 5S 
. RES 1 i SAVE DMACTL REGISTER 
. RES 1 i SAVE DISPLAY LIST LOW BYTE 
. RES 1 i SAVE DISPLAY LIST HI BYTE 
. RES 1 iSKCTL REGISTER RAM 
. RES 1 i 
. RES 1 iLIGHT PEN. HORIZONTAL VALUE 
. RES 1 iLIGHT PEN VERTICAL VALUE 
. RES 2 i BREAK KEY VECTOR 
. RES 2 i SPARE 
. RES 1 i COMMAND FRAME BUFFER — DEVICE 
. RES 1 i COMMAND 
.RES 1 i COMMAND AUX BYTE 1 
. RES 1 i COMMAND AUX BYTE 2 

MAY NOT BE THE LAST WORD ON A PAGE 
. RES 1 i TEMPORARY RAM CELL 

MAY NOT BE THE LAST WORD ON A PAGE 
. RES 1 i ERROR FLAG - ANY DEVICE ERROR EXCEPT TIME 0 
. RES 1 i DISK FLAGS FROM SECTOR ONE 
. RES 1 iNUMBER OF DISK BOOT SECTORS 
. RES 2 i ADDRESS WHERE DISK BOOT LOADER WILL BE PUT 
. RES 1 iCOLDSTART FLAG (1=IN MIDDLE OF COLDSTART> 
. RES 1 i; SPARE 
. RES 1 iDISK TIME OUT REGISTER 
. RES 40 i CHAR LINE BUFFER 
. RES 1 iGLOBAL PRIORITY CELL 
. RES iL iPOTENTIOMETER O RAM CELL 
. RES 1 
. RES 1 
. RES 1 
. RES 1 
. RES 1 
. RES 1 
. RES 1 
. RES 1 i JOYSTICK O RAM CELL 
. RES 1 
. RES 1 
. RES 1 
. RES 1 iPADDLE TRIGGER 0 
. RES 1 
. RES 5 
. RES A 
. RES 1 


PTRIG4: 
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388 0281 PTRIGS: .RES 1 
389 0282 PTRIG6: . RES 1 
390 0283 PTRIG7: .RES 1 
391 o284 STRIGO: .RES 1 ; JOYSTICK TRIGGER © 
392 0285 STRIGI: . RES 1 
393 0286 STRIG2: . RES 1 
394 0287 STRIGS: . RES 1 
395 F 
396 0288 CSTAT: .RES 1 
397 o289 WMODE: .RES 1 
398 O28A BLIM: .RES 1 
399 O28B IMASK: .RES 1 
400 O28C JVECK: RES 2 
401 i 
402 O28E _ RES 2 ; SPARE 
403 ; 
404 F 
405 i 
406 i 
407 0290 TXTROW: . RES 1 i; TEXT ROWCRS 
408 6291 TXTCOL: . RES 2 i TEXT COLCRS 
409 0293 TINDEX: . RES 1 ; TEXT INDEX 
410 6294 TXTMSC: .RES 2 ; FOOLS CONVRT INTO NEW MSC 
411 0296 TXTOLD: .RES & ;OLDROW &% OLDCOL FOR TEXT (AND THEN SOME) 
4i2 o629C¢ TMPX1: .RES 1 
413 O29D HOLDS: .RES 1 
414 O29E SUBTMP: .RES 1 
415 O29F HOLD2: .RES 1 
416 O2A0 DMASK: .RES i 
417 O2Al TMPLBT: .RES i 
418 O2A2 ESCFLG: . RES i ; ESCAPE FLAG 
419 O2A3 TABMAP: . RES i5 
420 O2ZB2 LOGMAP: . RES 4 ; LOGICAL LINE START BIT MAP 
421 O2B6 INVFLG: .RES 1 i; INVERSE VIDEO FLAG (TOGGLED BY ATARI KEY> 
422 0237 FILFLG: .RES 1 ;RIGHT FILL FLAG FOR DRAW 
423 o2Be TMPROW: .RES 1 
424 O2B9 TMPCOL: .RES 2 
425 O2BB SCRFLG: .RES 1 i SET IF SCROLL OCCURS 
426 O2BC HOLD4: .RES 1 ; TEMP CELL USED IN DRAW ONLY 
427 O2BD HOLDS: .RES t ; DITTO 
428 O2BE SHFLOK: . RES 1 
429 O2BF BOTSCR: .RES 1 ;BOTTOM OF SCREEN : 24 NORM 4 SPLIT 
430 i 
431 i 
432 02c0 PCOLRO: . RES 1 iPO COLOR 
433 o2C1 PCOLRi: .RES 1 ;P1 COLOR 
434 02C2 PCOLR2: . RES | ;P2 COLOR 
435 02c3 PCOLR3: . RES i ;P3 COLOR 
436 O02C4 COLORO: . RES 1 ; COLOR © 
437 O2cs COLOR1: .RES 1 
438 02C6 COLOR2: .RES 1 
439 02C7 COLORS: . RES 1 
1 


440 oO2cs COLOR4: .RES 
441 i 


ERR LINE 


442 
443 
444 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 
461 


462 . 


463 
464 
465 
466 
447 
468 
469 
470 
471 
472 
473 
474 
475 
476 
477 
478 
479 
480 
481 
482 
483 
484 
485 
486 
487 
498 
489 
490 
491 
492 
493 
494 
495 


ADDR Bi Be BS B4 


02C9 


OC2E0 
O2E0 


O2E4 
O2ES 
O2E7 
O2E9 
O2ZEA 
O2EE 
O2EF 


O2FO 
O2F 1 
02F2 


02F3 
O2F 4 


O2FS5 


Q2FA 
O02FB 
C2FC 
O2FD 
O2FE 
O2FF 


0300 
0300 
0301 
0302 
0303 
0304 
0305 
0306 
0307 
0308 
0309 
0304 
O3OB 


GLBABS 


s 


RAMSIZ: 
MEMTOP: 


MEML.O: 


DVSTAT: 
CBAUDL: 
CBAUDH: 


CRSINH: 
KEYDEL: 


CHIL: 


CHACT: 
CHBAS: 


DSPFLG: 
SSFLAG: 


? 
i 
i 
i 
i 
i 
i 
; 
i 


DCB 


DDEVIC: 


DUNIT: 


DCOMND: 
DSTATS: 
DBUFLO: 
DBUFHI: 
DTIMLO: 
DUNUSE: 
DBYTLO: 
DBYTHI: 


DAUX1: 
DAUX2: 


. RES 


- RES 
RES 
RES 


. RES 
. RES 


. RES 


.RES 
. RES 
. RES 
. RES 
. RES 
. RES 


PAGE 


= 
= 


. RES 
. RES 
. RES 
. RES 
.RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 
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a3 


& 


me Be A) lye 


hs ee pe 


me 


an 


PA RA A RA et 


i; SPARE 


iGLOBAL VARIABLES 
i SPARE 


iRAM SIZE (HI BYTE ONLY) 

i TOP OF AVAILABLE USER MEMORY 

; BOTTOM OF AVAILABLE USER MEMORY 
; SPARE 

i STATUS BUFFER 
; CASSETTE BAUD RATE LOW BYTE 


;CURSOR INHIBIT (00 = CURSOR ON) 
i KEY DELAY 


i CHACTL REGISTER RAM 
iCHBAS REGISTER RAM 


i SPARE BYTES 


i ATASCII CHARACTER 

i GLOBAL VARIABLE FOR KEYBOARD 

iRIGHT FILL DATA (BRAW) 

i DISPLAY FLAG : DISPLAY CNTLS IF NON-ZERO 
iSTART/STOP FLAG FOR PAGING (CNTL 1). CLEARE 


THREE RAM ASSIGNMENTS 


ey 


i DEVICE CONTROL BLOCK 

i PERIPHERAL UNIT 1 BUS I.D. NUMBER 
; UNIT NUMBER 

i BUS COMMAND 

i COMMAND TYPE/STATUS RETURN 

i DATA BUFFER POINTER LOW BYTE 


;DEVICE TIME OUT IN 1 SECOND UNITS 
i UNUSED BYTE : 
iNUMBER OF BYTES TO BE TRANSFERRED LOW BYTE 


i COMMAND AUXILIARY BYTE 1 
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4964 i 

497 O30C TIMERI: .RES 2 i INITIAL TIMER VALUE 

498 OS0E ADDCOR: .RES i i ADDITION CORRECTION 

499 O30OF CASFLG: .RES 1 i CASSETTE MODE WHEN SET 

300 60310 TIMER2: .RES 2 iFINAL TIMER VALUE. THESE TWO TIMER VALVES 
501 i ARE USED TO COMPUTE INTERVAL FOR BAUD RATE 

502 0312 TEMP 1: . RES 2 i TEMPORARY STORAGE REGISTER 
503 0314 TEMP2: . RES 1 i TEMPORARY STORAGE REGISTER 
504 0315 TEMPS: . RES 1 i TEMPORARY STORAGE REGISTER 
505 06316 SAVIO: . RES i iSAVE SERIAL IN DATA PORT 

506 0317 TIMFLG: .RES i i TIME OUT FLAG FOR BAUD RATE CORRECTION 
507 0318 STACKP: .RES 1 iSIO STACK POINTER SAVE CELL 
508 0319 TSTAT: . RES 1 i TEMPORARY STATUS HOLDER 

509 3 

510 i 

Sil ; 

S12 COS31A HATABS: . RES 38 i HANDLER ADDRESS TABLE 

513 0021 MAXDEV = #-HATABS-5S i MAXIMUM HANDLER ADDRESS INDEX 
514 i 

515 i NOTE : THE ENTIRE I0CB DEFINITIONS HAVE BEEN MODIFIED 
Sié i 

517 IOCB: ORG * iI/0 CONTROL BLOCKS 

518 0346 ICHID RES i i HANDLER INDEX NUMBER (FF = IOCB FREE? 
$19 O341 ICDNO RES 1 i DEVICE NUMBER (DRIVE NUMBER} 
S20 0342 I@COM RES 1 i COMMAND CODE 

S2l 0343 ICSTA RES 1 iSTATUS OF LAST IOCB ACTION 
522 0344 ICBAL RES 1 ;BUFFER ADDRESS LOW BYTE 

523. 0345 ICBAH: . RES i 

924 0346 ICPTL: . RES 1 iPUT BYTE ROUTINE ADDRESS - 1 
525 0347 ICPTH: RES 1 

9326 0348 ICBLL RES 1 i BUFFER LENGTH LOW BYTE 

527 ©6349 ICBLH RES 1 

928 O34A ICAX1 RES 1 i;AUXILIARY INFORMATION FIRST BYTE 
529? O34B ICAX2 RES 1 

930 O034C ICSPR RES 4 i FOUR SPARE BYTES 

331 0350 RES MAXIOC-IOCBSZ 

332 i 

533 oaco PRNBUF: .RES 40 iPRINTER BUFFER 

534 i 

535 O3E&8 . RES 21 iSPARE BYTES 

336 i 

537 i 

538 F 

539 i 

540 i 

341 i 

542 i 

543 i PAGE FOUR RAM ASSIGNMENTS 

$44 i 

5435 OSFD CASBUF: .RES 131 i CASSETTE BUFFER 

5446 i 

547 i USER AREA STARTS HERE AND GOES TO END OF PAGE FIVE 


548 0480 USAREA: . RES 128 - | SPARE 
549 : 


ERR LINE 


350 
ool 
352 
553 
554 
355 
356 
957 
$58 
359 
340 
S61 
362 
963 
964 
54S 
946 
967 
368 
969 
370 
S71 
S72 


$73: 


574 
375 
376 
S77 
378 
379 
580 
381 
982 
583 
984 
385 
586 
387 
588 
389 
390 
S71 
S92 
393 
394 
S95 
976 
597 
598 
399 
600 
601 
402 
603 


ADDR Bi B2 BS B4 


0006 
D&8OO 


DEES 
D9AA 


BID2 
DA&O 
DA&S 
DADB 
DB2e 
DDS9 
DDeD 
DD9S 
BD9C 
DDA7 
DDAB 
DDBG 
DD40 


DDCO 
DDCC 
DECD 
DED1 


BDS1 
BD73 
BE43 
BEB1 


i 
; 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
; 
; 
i 


FPREC 


i IF CARRY USED THEN CARRY CLEAR => NO ERROR, 


AFP 


FASC 
IFP 
FPI 
FSUB 
FADD 
FMUL 
FDIV 
FLDOR 
FLDOP 
FLDIR 
FLDIP 
FSTOR 
FSTOP 
FMOVE 
PLYEVL 


LOGIO 
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PAGE FIVE RAM ASSIGNMENTS 


PAGE 12 


PAGE FIVE IS RESERVED AS A USER WORK SPACE 


NOTE: SEE FLOATING POINT SUBROUTINE AREA FOR PAGE FIVE CELLS 


PAGE SIX RAM ASSIGNMENTS 


FLOATING POINT SUBROUTINES 


PAGE SIX IS RESERVED AS A USER’‘’S USER WORK SPACE 


_ 
= 


& 


i FLOATING PT PRECISION (# OF BYTES) 
CARR 


= $DSco i ASCII->FLOATING POINT (FP) 
INBUFF+CIX ~-> FRO, CIX, CARRY 
= $DSE6 iFP -> ASCII FRO-> LBUFF (CINBUFF> 
= SBDPAA i INTEGER -> FP 
O-$FFFF (LSB,MSB) IN FRO, FRO+1->FRO 

= $D9D2 iFP -> INTEGER FRO -> FRO, FRO+1i, CARRY 
= $DASC iFRO <- FRO —- FRI . CARRY 
= $DAGG i#FRO <- FRO + FRI . CARRY 
= $DADB iFRO <- FRO # FRI . CARRY 
= $DB28 iFRO <- FRO / FRI CARRY 
= $DD89 i FLOATING LOAD REGO FRO <- (X,Y) 
= $DD8D i . oe i FRO <- (FLPTR?> 
= $DD93 i ‘ _ REG1 FRi <- (X,Y? 
= $DB9C i se sd * FRi <- (FLPTR) 
= $DDA7 iFLOATING STORE REGO (X,Y) <- FRO 
= SDDAB i . - “ (FLPTR} <- FRO 
= $DDBG iFRI <- FRO 
= $DD40 FRO <- P(Z) = SUMCI=N TO 0) (ACT) #Z##1I) CAR 

INPUT: (X,Y) = ACN}, ACN-1)...A(0) —-> PLYARG 

ACC = # OF COEFFICIENTS = DEGREE+1 
FRO = Z 

= SDDCO iFRO <- EX#FRO = EXPIOCFRO #* LOGIO(E))? CARRY 
= SDDBCC iFRO <- 1LO##FRO CARRY 
= $DECD iFRO <- LNC(FRO) = LOGIO(CFRO)/LOGIO(CE) CARRY 
= $DEDi iFRO <- LOGIO (FRO) CARRY 


i THE FOLLOWING ARE IN BASIC CARTRIDGE: 


SIN 
cos 
ATAN 
SGR 


$BD81 
$BD73 
$BE43 
$BEBi 


iFRO <- SIN(CFRO) DEGFLG=0 =2RADS, 
iFRO <- COS(FRO) CARRY 

iFRO <- ATANC(CFRO) CARRY 

iFRO <- SQUARERODOT(FRO) CARRY 


4=>DEG. CA 


ERR LINE 


604 
609 
606 
607 
608 
609 
610 
611 
12 
613 
614 
415 
616 
617 
618 


ADDR 


OOoD4 
OODA 
OOEO 
OCE6 
OOEC 
OOED 
OOEE 
OOEF 
OOFO 
OOF 1 
OOF2 
OOF3 
OOFS 
OOF7 
OOF9 
OOFB 
OOFB 
0000 
0006 
OOFC 
OOFE 


OS7E 


OS7F 
0580 
OSEO 
OSEG 
OSEC 
OSES 
OSEC 
OSFF 


D200 
D200 
D201 
D202 
D203 
D204 
D205 
D206 


Bi Be BS B4 
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i FLOATING POINT ROUTINES ZERO PAGE (NEEDED ONLY IF F.P. ROUTINES ARE CA 


FRO: 
FRE: 
FRi: 
FRe2: 
FRX: 
EEXP: 
NSIGN: 
ESIGN: 


DIGRT: 
CIX: 


INBUFF: 
ZTEMP 1: 
ZTEMP4: 
ZTEMP3: 


DEGFLG 


RADFLG: 


RADON 
DEGON 
FLPTR: 
FPTR2: 


#=$D4 


. RES 
. RES 
. RES 
.RES 
. RES 
. RES 
. RES 
. RES 
FCHRFLG: . 
. RES 
. RES 
. RES 
. RES 
. RES 
. RES 


RES 


. RES 


RES 
RES 


FPREC i FP REGO 

FPREC 

FPREC iFP REGI 

FPREC 

1 i FP SPARE 

1 +VALUE OF E 

1 i SIGN OF # 

1 i+SIGN OF EXPONENT 

1 + iST CHAR FLAG 

1 i# OF DIGITS RIGHT OF DECIMAL 
1 iCURRENT INPUT INDEX 

2 ;POINTS TO USER’S LINE INPUT BUFFER 
2 

2 

2 


; O=RADIANS, 6=DEGREES 

i INDICATES RADIANS 

i INDICATES DEGREES 

i;POINTS TO USER‘S FLOATING PT NUMBER 


MMO Or 


i FLOATING PT ROUTINES’ NON-ZERO PAGE RAM 
i (NEEDED ONLY IF F.P. ROUTINES CALLED) 


LBPR1: 
LBPR2: 
LBUFF: 
PLYARG 
FPSCR 
FPSCRi 
FSCR 
FSCRi 
LBFEND 


#=$57E 


ion tun 


(2) 
Q 
fe 
r 
m 
m 
Zz 


Hu nh eon en 


RES 
RES 
RES 


1 iL BUFF PREFIX 1 

1 iLBUFF PREFIX 2 

128 iLINE BUFFER 

LBUFF+$40 i POLYNOMIAL ARGUMENTS 

PLYARG+FPREC 

FPSCR+FPREC 

FPSCR 

FPSCR1 

#—1 i END OF LBUFF 

MNEMONICS 

$D200 i VBLANK ACTION: DESCRIPTION: 
POKEY+0 i POTO~->PADDLO 0-227 IN RAM CELL 
POKEY+1 i POTi~-->PADDL1 0-227 IN RAM CELL 
POKEY+2 i POT2-->PADDL2 0-227 IN RAM CELL 
POKEY+3 i POT3-->PADDL3 0-227 IN RAM CELL 
POKEY+4 i POT4-->PADDL4 0-227 IN RAM CELL 
POKEY+S i POTS~-->PADDLS 0-227 IN RAM CELL 
POKEY+4 i POTS~-->PADDLG 0-227 IN RAM CELL 


ERR LINE 


658 
489 
460 
661 
662 
6643 
664 
465 
666 
647 
648 
669 
670 
671 
672 
673 
&74 
675 
476 
477 
678 
679 
480 
681 
682 
683 
684 
685 
686 
687 
688 
689 
490 
491 
692 
693 
&94 
695 
496 
697 
698 
699 
700 
7O1 


Bi B2 B3 B4 


POT7 

ALLPOT 
KBCODE 
RANDOM 
POTGO 
SERIN 
IRQST 
SKSTAT 
AUDF 1 

AUDCi 

AUDF2 
AUDC2 
AUDFS3 
AUDC3 
AUDF4 
AUDC4 
AUDCTL 
STIMER 
SKRES 
SEROUT 
IRGEN 
SKCTL 


CTIA 

HPOSPO 
HPOSP 1 
HPOSP2 
HPOSP3 
HPOSMO 
HPOSM1 
HPOSM2 
HPOSM3 
SIZEPO 
SIZEPI 
SIZEP2 
SIZEPS3 
SIZEM 

GRAFPO 
GRAFP i 
GRAFP2 
GRAFP3 
GRAFM 

COLPMO 
COLPM1 
COLPM2 
COLPM3 
COLPFO 
COLPF i 
COLPF2 
COLPFS3 
COLBK 

PRIOR 

VDELAY 
GRACTL 


hunk aun td @ ib t bt tant nt wa 


1 |) | | | | | | | i | | 
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POKEY+7 
POKEY+8 
POKEY+9 
POKEY?+10 
POKEY+11 
POKEY+13 
POKEY+14 
POKEY+15 
POKEY+0 
POKEY?+1 
POKEY+2 
POKEY+3 
POKEY?4 
POKEY+5 
POKEY+6 
POKEY+7 
POKEY+8 
POKEY+9 
POKEY+10 
POKEY+13 
POKEY+14 
POKEY+15 


$DO00 
CTIA+0 
CTIA+1 
CTIAt+2 
CTIA+S3 
CTIA+4 
CTIAt+S 
CTIAt+E 
CTIA+7 
CTIA+8 
CTIA+9 
CTIA+1i1G 
CTIA+L1 
CTIAt+12 
CTIAt13 
CTIAt+14 
CTIAt+15 
CTIAt+16 
CTIAt17 
CTIAt18 
CTIA+1LF 
CTIA+26 
CTIAt+21 
CTIA+22 
CTIA+23 
CTIA+24 
CTIAt+25 
CTIAt+2Z6 
CTIAt2Z7 
CTIAt+28 
CTIA+29 


i POT7-->PADDL7 
i PP? 


i STROBED 


i NONE 


i NONE 
i NONE 


i SSKCTL~-2SACTL 


i VBLANK ACTION: 


i PCOLRO--2>COLPMO 

i PCOLR1-~->COLPM1 

i PCOLR2-->COLPM2 

i PCOLRS—-—->COLPM3 

i; COLORG-—~->COLPFO 

; COLOR1-->COLPF1 

i COLOR2--SCOLPF2 

i COLORS-->COLPFS 

; COLOR4—-->COLBK 

i (ON OPEN S: OR E: ) 


PAGE 14 


0-227 IN RAM CELL 


SKRES<--CSIOJ 
SEROUT<--CSIO] 
i POKMSK-->IRGEN (AFFECTED BY OPEN S: 
SSKCTL*--CSIOI 


. AUDCTL<--CSIO] 


DESCRIPTION: 


WITH 
WITH 
WITH 
WITH 
WITH 
WITH 
WITH 
WITH 
WITH 


ATTRACT 
ATTRACT 
ATTRACT 
ATTRACT 
ATTRACT 
ATTRACT 
ATTRACT 
ATTRACT 
ATTRACT 


OR E:) 


MODE 
MODE 
MODE 
MODE 
MODE 
MODE 
MODE 
MODE 
MODE 


GPRIOR-~->PRIOR 


ERR LINE 


ADDR 


DOIE 
DOLF 
BoCco 
DOO1 
Boo2 
BOOS 
DOO4 
BOOS 
DOOS 
DOO7 
DOoOos 
DCO? 
DOOA 


DOOB 


DOOC 
DCOD 
DOOE 
DOOF 
DO10 
DO11 
DO12 
DO1L3 


D400 
D400 
D401 
D402 
D403 
D404 
D405 
D407 
D409 
D40A 
D40B 
D40C 
D40D 
D40E 
D40F 
D40F 
D300 
D300 
DI01 
D302 
D303 


Bi B2 B32 B4a 


HITCLR 
CONSOL 
MOPF 
MIPF 
M2PF 
MSPF 
POPF 
PiPF 
P2PF 
P3PF 


nn | | | | | | | 
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CTIAt+3O 
CTIA+31 
CTIA+G 
CTIAt+1 
CTIA+2 
CTIA+3 
CTIA+4 
CTIAtS 
CTIAt4G 
CTIA+7 
CTIA+S 
CTIA+9 
CTIA+10 
CTIA+1i1 
CTIA+i2S 
CTIA+13 
CTIA+14 
CTIAt+1§ 
CTIAt+16 
CTIA+17 
CTIAt1i8 
CTIAt19 


$D400 
ANTIC+0 
ANTIC+1 
ANTIC+2 
ANTIC+3 
ANTIC+4 
ANTIC+5 
ANTIC+7 
ANTIC+9 
ANTIC+1i0 
ANTIC+11 
ANTIC+i2 
ANTIC+13 
ANTIC+14 
ANTIC+15 
ANTIC+1i5 
$D300 
PIA+G 
PIA+1 
PIA+2 
PIA+3 


& 


; $O08-->CONSOL. 


i TRIGO-~—>STRIGO 
i TRIGI-->STRIGI 
i TRIG2-->STRIG2 
i TRIGG-->STRIGS 


i VBLANK ACTION 

i DMACTL<—--SDMCTL. 
i CHACTL<-—CHACT 
i DLISTL<--SDLSTL 
i DLISTH<--SDLSTH 


i CHBASE<:-—-CHBAS 


iNMIEN<-~-40 POWER 
i STROBED 


iVBLANK ACTION 

i PORTA--—>STICKO, 1 
i PORTB-->STICK2, 3 
i NONE 

+ NONE 


PAGE 


TURN OFF SPEAKER 


DESCRIPTION 

ON OPEN S: OR 
ON OPEN S: OR 
ON OPEN S: OR 
ON OPEN S: OR 


ON OPEN S: OR E: 


ON AND CSETVBV] 


DESCRIPTION 

X-Y CONTROLLERS 
X-Y¥ CONTROLLERS 
PACTL<--3C CINIT] 
PBCTL<--3C CINITI 


15 
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760 . PAGE 

74l LIST Ss 

762 TITLE ‘CENTRAL INPUT/OQUTPUT (CIO) 2-7-79° 
763 i UPDATED BY AL MILLER 3-9-79 

764 0030 ASCZER = ‘oO iASCII ZERO 

765 OO0O3A COLON = $3A iASCIT COLON 

766 0098 EOL = $9B i END OF RECORD 


ERR LINE 


747 
768 


ADDR Bi Be BS B4 


E456 4C C4 £4 


E46E 4C Ab E4 


AC 
60 


85 


03 
03 


ee ee ee ee Se Ta Ty 


#=C TOORG 
+ CIO INITIALIZATION (CALLED BY MONITOR AT POWER UP) 
CIOINT: LDX #0 
CIOli: LDA #IOCFRE 
STA ICHID. X 
LDA #ERR TNL 
STA ICPTL, X 
LDA #ERRTNH 
STA ICPTH. X 
TXA 
CLC 
ABC #IOCBSZ i BUMP INDEX BY SIZE 
TAX 
CMP #MAX IOC i; DONE? 
BCC CIOr1 iNO 
RTS i YES, RETURN 


CENTRAL INPUT/OUTPUT (CIO) 2-7-79 


. PAGE 
CIO JUMP VECTOR FOR USERS 
#=C IOV 
JUMP cio iGO TO CIO 
CIO INIT JUMP VECTOR FOR POWER UP 
#=CIOINV 
JMP CIOINT iGO TO INIT 


ERROR ROUTINE ADDRESS EQUATE 
ERRTNH =ERRTN/256 


ERROR ROUTINE FOR ILLEGAL PUT 


ERRTN =H—-1 
ERRTNH =ERRTN/256 
ERRTNL =(-ERRTNH}#256+ERRTN 


LDY #NOTOPN 
RTS 


“MOVED TO LINE 788" 
ERRTNL =-ERRTNH#254+ERRTN “MOVED TO LINE 789" 


iSET ALL IOCB’S TO FREE 
iBY SETTING HANDLER ID’S=$FF 


i#POINT PUT TO ERROR ROUTINE 


i IO0CB NOT OPEN 


PAGE 
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ERR LINE 


807 
808 


ADDR 


002C 


E4c4 
E4C6 


E4cs 
E4c9 
E4CB 
E4CD 
E4CF 


E4D1 
E4D3 


E4D6 
E4D8 
E4DB 
E4DE 
E4DF 
E4E0 
E4E2 


E4E4 
E4E6 
E4E8 
E4EA 
E4EC 


E4ED 
E4EF 
E4F 1 
E4F3 
E4F5 
E4F8 
E4&FA 
E4FC 
E4Fe 
ESOO 
E502 
E504 
E506 


Bi B2 BS B4 


1B E& 


40 03 
20 00 


C& E& 


CENTRAL INPUT/OUTPUT (CIO) 


. PAGE 


‘ 


2-7-79 PAGE 


i CIO LOCAL RAM (USES SPARE BYTES IN ZERO PAGE IOCB> 


ENTVEC = ICSPRZ 


i CIO MAIN ROUTINE 


. 
! 


i; CIO INTERFACES BETWEEN USER AND INPUT/OUTPUT DE 


cio: STA CIOCHR i SAVE POSSIBLE OUTPUT CHARACTER 
STX ICIDNO iSAVE IOCB NUMBER # N 
i CHECK FOR LEGAL IOCB 
TXA 
AND #SF iI1S IOCB MULTIPLE OF 16? 
BNE CIERRI iNO, ERROR 
CPX #MAXIOC iIS INDEX TOO LARGE? 
BCC Toci iNO 
i INVALID IOCB NUMBER -- RETURN ERROR 
CIERRi: LDBY #BADIOC i; ERROR CODE 
JMP CIRTNI i RETURN 
; MOVE USER IOCB TO ZERO PAGE 
IO0Cc1: LDY #0 
IOCiA: LDA IOCB, xX ;USER IOCB 
STA IOCBAS. Y i TO ZERO PAGE 
INX 
INY 
CPY #12 ii2 BYTES 
BCC IOCiA 
; COMPUTE CIO INTERNAL VECTOR FOR COMMAND 
LDY #NVAL ID i ASSUME INVALID CODE 
LDA ICCOMZ i COMMAND CODE TO INDEX 
CMP #0PEN i IS COMMAND LEGAL’? 
BCC CIERR4 i NO 
TAY 
i; MOVE COMMAND TO ZERO BASE FOR INDEX 
CPY #SPECIL i IS COMMAND SPECIAL? 
BCC Toc2 iNO 
LDY #SPECIL i YES, SET SPECIAL OFFSET INDEX 
TO0C2: STY ICCOMT i SAVE COMMAND FOR VECTOR 
LDA COMTAB-3, Y ;GET VECTOR OFFSET FROM TABLE 
BEG CIOPEN iGO IF OPEN COMMAND 
CMP #2 i1S IT CLOSE? 
BEG cIcLos ; YES 
CMP #3 i IS IT STATUS OR SPECIAL? 
BCS cIsTspe i YES 
CMP #4 IS IT READ? 
BEG CIREAD i YES 
JMP CIWRIT i;ELSE, MUST BE WRITE 
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ERR LINE 


ADDR 


ESO9 
ESOB 
ESOD 


ESOF 
ESii 


E514 
E517 


ES1i9 
ESic 


ESIiE 


E521 
E523 
E525 
E528 
ES2A 
E52C 
ES2E 
E530 


Bi 


B2 BS B4 


E6 


E6 


E6é 


ES 


E6 


ES 


CENTRAL INPUT/OUTPUT (CIO} 2-7-79 PAGE 
. PAGE 
OPEN COMMAND 


i FIND DEVICE HANDLER IN HANDLER ADDRESS TABLE 
CIOPEN: LDA ICHIDZ 


iGET HANDLER ID 
CMP #IOCFRE iIS THIS 10CB CLOSED? 
BEG Tocé i YES 
i ERROR -- IOCB ALREADY OPEN 
CIERRS: LDBY #PRVOPN i#ERROR CODE 


CIERR4: JMP CIRTN1 i RETURN 

i GO FIND DEVICE 

Tocé: JSR DEVSRC 
BcS CIERR4 


iCALL DEVICE SEARCH 
iGO IF DEVICE NOT FOUND 


i DEVICE FOUND. INITIALIZE IOCB FOR OPEN 
i COMPUTE HANDLER ENTRY POINT 
I 


OC7?: JSR COMENT 


BCS CIERR4 iGO IF ERROR IN COMPUTE 


i GO TO HANDLER FOR INITIALIZATION 


JSR GOHAND iUSE INDIRECT JUMP 

i STORE PUT BYTE ADDRESS-1 INTO IOCB 
LDA #PUTCHR i SIMULATE PUT CHARACTER 
STA ICCOMT 
JSR COMENT i COMPUTE ENTRY POINT 
LDA ICSPRZ +MOVE COMPUTED VALUE 
STA ICPTLZ +; TO PUT BYTE ADDRESS 
LDA ICSPRZ+1 
STA ICPTHZ 
JMP CIRTN2 i RETURN TO USER 
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ERR LINE 


894 
895 
B96 
897 
898 
899 
900 
901 
902 
903 
904 
905 
906 
907 
908 
909 


ADDR 


ES33 
ES35 
E537 
ES3A 
E53C 
ES3SF 
ES41 
E543 
ES45 
E547 
ES49 
ES4B 


ES4E 
ES50 
ESS2 


ESS4 
E557 


ES59 
ESSC 


ESSF 
E561 
E564 
E566 


Bi 


Be 


B32 B4 


ES 


E& 


EG 


EG 


ES 
EG 


03 


E6 


CENTRAL INPUT/OUTPUT (CIO>} 


i 


i 


i CLOSE COMMAND 


CICLOS: 


cIcLo2: 


. PAGE 


LDY 
STY 
JSR 
BCS 
JSR 
LDA 
STA 
LDA 
STA 
LDA 
STA 
JMP 


#SUCCES 
ICSTAZ 
COMENT 
cicio2 
GOHAND 
#IOCFRE 
ICHIBZ 
#ERRTNH 
ICPTHZ 
#ERR TNL 
ICPTLZ 
CIRTN2 


2-7-79 


PAGE 


i ASSUME GOOD CLOSE 


i COMPUTE HANDLER ENTRY POINT 
iGO IF ERROR IN COMPUTE 

iGO TO HANDLER TO CLOSE DEVICE 
iGET IOCB “FREE” VALUE 

i SET HANDLER ID 


i SET PUT BYTE TO POINT TO ERROR 


i RETURN 


STATUS AND SPECIAL REQUESTS 
DO IMPLIED OPEN IF NECESSARY AND GO TO DEVICE 


CISTSP: 


i IOCB IS FREE, 


i 


i 1S THERE A HANDLER ID? 


i YES 


DO IMPLIED OPEN 


iFIND DEVICE IN TABLE 
iGO IF ERROR IN COMPUTE 


i COMPUTE AND GO TO ENTRY POINT IN HANDLER 


CISTI: 


. 
‘ 


i RESTORE HANDLER INDEX (DO 


LDA ICHIDZ 
CMP #IOCFRE 
BNE cIsTi 
JSR DEVSRC 
BCS CIERR4 
JSR COMENT 
JSR GOHAND 
LDX ICIDNO 
LDA ICHID, X 
STA ICHIDZ 
JMP CIRTN2 


i COMPUTER HANDLER ENTRY VECTOR 
*GO TO HANDLER 


IMPLIED CLOSE} 

iIOCB INDEX 

iGET ORIGINAL HANDLER ID 
iRESTORE ZERO PAGE 

i RETURN 
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ERR LINE 


931 
932 
933 
934 
935 
936 
937 
938 
939 
940 
941 
942 
943 
944 
945 
946 
947 
948 
949 
950 
951 
952 
953 
954 
955 
956 
957 
958 
959 
940 
F1 
962 
963 
964 
965 
966 
967 
968 
969 
970 
971 
972 
973 
974 


ADDR 


E569 
ES6B 
E546D 


ESOF 
ES71 


ES74 
ES77 


ES79 
ES7B 
ES7D 
ES7F 
E562 
ES84 


ES87 
ESBA 
ESac 
ESSE 
ES96 
ES92 
ES9S 
E597 
E599 


ES9B 
ES?D 
ESOF 
ESA1 
ESA4 


ESA7 
ESAA 


Bi 


B2 BS B4 


EG 


ES 


Eé 


E6 


Eé 


Eé 


ES 
ES 


Eé 


CENTRAL INPUT/OUTPUT (CIO} 2-7-79 PAGE 


. PAGE 
i READ -- DO GET COMMANDS 
CIREAD: LDA IccOMz iGET COMMAND BYTE 
AND ICAX1iZ i IS THIS READ LEGAL? 
BNE RCLiA i YES 
> ILLEGAL READ -~- IOCB OPENED FOR WRITE ONLY 
LDY #WRONLY ;ERROR CODE 
RCI1B: JUMP CIRTN1 ; RETURN 
i 
i; COMPUTE AND CHECK ENTRY POINT 
RCIiA: JSR COMENT i COMPUTE ENTRY POINT 
BCS RCIiB iGO IF ERROR IN COMPUTE 
i GET RECORD OR CHARACTERS 
LDA ICBLLZ 
ORA ICBLLZ+1 i IS BUFFER LENGTH ZERO? 
BNE RCI3 iNO 
JSR GOHAND 
STA CIOCHR 
JMP CIRTN2 
; LOOP TO FILL BUFFER OR END RECORD 
RCIS: JSR GOHAND iGO TO HANDLER TO GET BYTE 
STA CIOCHR iSAVE BYTE 
BMI RCI4 ;END TRANSFER IF ERROR 
LDY #0 
STA (ICBALZ},Y iPUT BYTE IN USER BUFFER 
JSR INCBFP i; INCREMENT BUFFER POINTER 
LDA Iccomz +GET COMMAND CODE 
AND #2 iIS IT GET RECORD? 
BNE RCI1 + NO 
i CHECK FOR EOL ON TEXT RECORDS 
LDA CIOCHR iGET BYTE 
CMP #E0OL i IS IT AN EOL? 
BNE RCIi iNO 
JSR DECBFL i YES, DECREMENT BUFFER LENGTH 
JMP RCI4 i END TRANSFER 
i CHECK BUFFER FULL 
RCI1: JSR DECBFL ; DECREMENT BUFFER LENGTH 
BNE RCI i CONTINUE IF NON ZERO 


ERR LINE 


973 
976 


ADDR 


ESAC 
ESAE 
ESBO 


ESB2 
ESBS 
ESB7 


ESB? 
ESBB 
ESBD 


ESBF 
ESC1 


ES5C3 
ESC6 


Bi 


Be BS B4 


B89 EG 


CENTRAL INPUT/OUTPUT (CIO) 2-7-79 PAGE 


. PAGE 
i BUFFER FULL, RECORD NOT ENDED 
i DISCARD BYTES UNTIL END OF RECORD 


RCI2: LDA ICCOMZ iGET COMMAND BYTE 
AND #2 iIS IT GET CHARACTER? 
BNE RCI4 i YES, END TRANSFER 
.¢ LOOP TO WAIT FOR EOL 
RCIé: JSR GOHAND iGET BYTE FROM HANDLER 
STA CTOCHR i SAVE CHARACTER » 
BMI RCI4 iGO IF ERROR 
i TEXT RECORD, WAIT FOR EOL 
LDA CIOCHR iGET GOT BYTE 
CMP #E0L iIS IT EOL? 
BNE RCIG iNO, CONTINUE 
i END OF RECORD, BUFFER FULL -- SEND TRUNCATED RECORD MESSAGE 
RCIii: LBA #TRNRCD iERROR CODE 
STA ICSTAZ i STORE IN IOCB 
i TRANSFER DONE 
RCI4: JSR SUBBFL i SET FINAL BUFFER LENGTH 
JMP CIRTN2 i RETURN . 


ERR LINE 


1000 
1001 
1002 
1003 
1004 
1005 
1006 
1007 
1008 
1009 
1010 
1011 
1012 
1013 
1014 
1015 
1016 
1017 
1018 
1019 
1020 
1021 
1022 
1023 
1024 
1025 
1026 
1027 
1028 
1029 
1030 
1031 
1032 
1033 
1034 
1035 
1036 
1037 
1038 
1039 
1040 
1041 
1042 
1043 
1044 
1045 


ADDR 


ESC? 
ESCB 
ESCD 


ESCF 
ESD1i 


ESD4 
ESD7 


ESD? 
ESDB 
ESDD 
ESDF 
ESE1 
ESES 


ESES 
ESE7 
ESE? 
ESEB 
ESEE 
ESFO 


ESFS 
ESFS 
ESF7 


ESF9 
ESFB 
ESFD 
ESFF 
E602 


E405 
E608 


Bi 


Be BS B4 


Eé 


ES 


Eé 


E& 


ES 
E46 


E6 


CENTRAL INPUT/OUTPUT (CIO} 2-7-79 PAGE 


. PAGE 


i WRITE -- DO PUT COMMANDS 


CIWRIT: LDA ICCOMZ iGET COMMAND BYTE 
AND ICAX1iZ iIS THIS WRITE LEGAL? 
BNE WCIIA i YES 

i ILLEGAL WRITE -- DEVICE OPENED FOR READ ONLY 
LDY #RDONLY ;ERROR CODE 


WCI1B: JMP CIRTN1 i RETURN 

i 

+ COMPUTE AND CHECK ENTRY POINT 

WCI1A: JSR COMENT i COMPUTE HANDLER ENTRY POINT 
BCS WCI1B iGO IF ERROR IN COMPUTE 


i PUT RECORD OR CHARACTERS 


LDA ICBLLZ 
ORA ICBLLZ+1 iIS BUFFER LENGTH ZERO? 
BNE WCI3 iNO 
LDA CIOCHR iGET CHARACTER 
INC ICBLLZ i SET BUFFER LENGTH=1 
BNE WCI4 i THEN JUST TRANSFER ONE BYTE 
; LOOP TO TRANSFER BYTES FROM BUFFER TO HANDLER 
WCI3: LDY #0 
LDA (ICBALZ), Y iGET BYTE FROM BUFFER 
STA C ITOCHR i SAVE 
WCI4: JSR GOHAND iGO PUT BYTE 
BMI WCIS iEND IF ERROR 
JSR INCBFP i INCREMENT BUFFER POINTER 


i CHECK FOR TEXT RECORD 


LDA ICCOMZ iGET COMMAND BYTE 
AND #2 iIS IT PUT RECORD? 
BNE WCIi iNO 


i TEXT RECORD -- CHECK FOR EOL TRANSFER 


LDA CIOCHR iGET LAST CHARACTER 

CMP #E0L iIS IT AN EOL? 

BNE WCIi iNO 

JSR DECBFL i DECREMENT BUFFER LENGTH 
JMP WCIS i END TRANSFER 


i CHECK FOR BUFFER EMPTY 
WCI1: JSR DECBFL i DECREMENT BUFFER LENGTH 
BNE WCIS i CONTINUE IF NON ZERO 
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ERR LINE 


1046 
1647 
1048 
1049 
1050 
1051 
1052 
1653 
1054 
1055 
1056 
1057 
1058 
1059 
1040 


ADDR 


EGOA 
E460C 
E6OE 


E610 
E612 


E615 
E618 


B1 


B2 BS B4 


CENTRAL INPUT/OUTPUT (CIO} 2-7-79 PAGE 


. 
a 


i BUFFER EMPTY, 


WC I2: 


i 


i 


. PAGE 


RECORD NOT FILLED 
i CHECK TYPE OF TRANSFER 


i END PUT TRANSFER 


WCIS: 


LDA ICCOMZ 

AND #2 

BNE WCIS 

; PUT RECORD (TEXT), BUFFER 

LDA #E0L 

JSR GOHAND 

JSR SUBBFL 

JMP CIRTN2 


iGET COMMAND CODE 

i IS IT PUT CHARACTER? 
i YES, END TRANSFER 
EMPTY, SEND EOL 

*GO TO HANDLER 


iSET ACTUAL PUT BUFFER LENGTH 
; RETURN 
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ERR LINE 


1061 
1062 
1063 
1064 
1045 


ADDR 


E61B 


Bi 


84 


Be BS B4 


23 


03 


03 


03 


CENTRAL INPUT/OUTPUT (CIO} 2-7-79 PAGE 


. PAGE 
i CIO RETURNS 
i RETURNS WITH Y=STATUS 
CIRTNi: STY ICSTAZ i SAVE STATUS 
i RETURNS WITH STATUS STORED IN ICSTAZ 
i MOVE IOCB IN ZERO PAGE BACK TO USER AREA 


CIRTNe2: LDBY IC IBNO iGET TOCB INDEX 
LDA ICBAL, ¥ : 
STA ICBALZ iRESTORE USER BUFFER POINTER 
LDA ICBAH. Y 
STA ICBAHZ 
LDX #0 iLOOP COUNT AND INDEX 
CIRTS3: LDA IOCBAS, X i ZERO PAGE 
STA IOcB. Y i TO USER AREA 
INX 
INY 
CPX #i2 ii2 BYTES 
BCC CIRTS 


. 
a 


i RESTORE A,X, & Y¥ 


LDA CTOCHR iGET LAST CHARACTER 

LDX ICTDNO iTOCB INDEX 

LDY ICSTAZ iGET STATUS AND SET FLAGS 
RTS iRETURN TO USER 
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ERR LINE 


1087 
1088 
1089 
1090 
1091 
1092 
1093 
1094 
1095 
1096 
1097 
1098 
1099 
1100 
1101 
1102 
1103 
1104 
1105 
1106 
1107 
1108 
1109 
1110 
1111 
1112 
1113 
1114 
1115 
1116 
1117 
1118 
1119 
1120 
1i2i 
lige 
1123 
1124 
1125 
1126 
1127 
1128 
1129 
1130 
1131 
1132 
1133 
1134 
1135 
1136 
1137 
1138 
1139 
1140 


ADDR 


Bi 


Be BS B4 


ic 03 


C& ES 


48 03 


CENTRAL INPUT/OUTPUT (CIO) 2-7-79 


. PAGE 


CIGQ SUBROUTINES 


PAGE 


i COMENT -- CHECK AND COMPUTE HANDLER ENTRY POINT 
C 


OMENT: LDY ICHIDZ iGET HANDLER INDEX 
CPY #MAXDEV+1 iIS IT A LEGAL INDEX? 
BCC COMi i YES 
i ILLEGAL HANDLER INDEX MEANS DEVICE NOT OPEN FOR OPERATION 
LDY #NOTOPN iERROR CODE 
BCS come i RETURN 


i 


i USE HANDLER ADDRESS TABLE 


AND COMMAND TABLE TO GET VECTOR 


COM1: LDA HATABS+1,Y iGET LOW BYTE OF ADDRESS 
STA ICSPRZ i AND SAVE IN POINTER 
LDA HATABS+2,Y iGET HI BYTE OF ADDRESS 
STA ICSPRZ+1 
LDY IcCcCOMT iGET COMMAND CODE 
LDA COMTAB-3.,Y i GET COMMAND OFFSET 
TAY 
LDA CICSPRZ},Y i;GET LOW BYTE OF VECTOR FROM 
TAX iHANDLER ITSELF AND SAVE 
INY 
LDA C(ICSPRZ>,.Y iGET HI BYTE OF VECTOR 
STA ICSPRZ+1 
STX ICSPRZ iSET LO BYTE 
CLC i SHOW NO ERROR 
come: RTS 
+ DECBFL -- DECREMENT BUFFER LENGTH DOUBLE BYTE 
i Z FLAG = O ON RETURN IF LENGTH = O AFTER DECREMENT 
DECBFL: DEC ICBLLZ i DECREMENT LOW BYTE 
LDA ICBLLZ i CHECK IT 
CMP #$FF iDID IT GO BELOW? 
BNE DECBF1 i NO 
DEC ICBLLZ+1 i DECREMENT HI BYTE 
DECBFi: ORA ICBLLZ+i1 iSET Z IF BOTH ARE ZERO 
RTS , 
i INCBFP -- INCREMENT WORKING BUFFER POINTER 
INCBFP: INC ICBALZ i BUMP LOW BYTE 
BNE INCBF 1 iGO IF NOT ZERO 
INC ICBALZ+1 i#ELSE, BUMP HI BYTE 


INCBFi: RTS 


; 


i SUBBFL -- 
SUBBFL: LDX 
SEC 
LDA 


ICIBNO 


ICBLL, X 


SET BUFFER LENGTH = BUFFER LENGTH - WORKING BYTE COUNT 


iGET IOCB INDEX 


iGET LOW BYTE OF INITIAL LENGTH 
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ERR LINE 


1141 
1142 
1143 
1144 
1145 
1146 
1147 
1148 
1149 
1150 
1151 
1152 
1153 
1154 
1155 
1156 
1157 
1158 
1159 
1160 
1161 
1142 
1163 
1164 
1165 


ADDR 


E&7D 
E67F 
E681 
E684 
E486 
E4688 


Eé89 
Eé8B 
E468E 
E490 
E692 


E493 
E694 
E696 
E697 
E&99 
E49A 
E69B 
E&9D 


B2 BS B4 


2c 


2eE 


03 


ES 


CENTRAL INPUT/OUTPUT (CIO} 


i 
i 
i 
i 


GOHAND: 


. 
a 


SBC 
STA 
LDA 
SBC 
STA 
RTS 


GOHAND —- 
Y= STATUS 


ICBLLZ 
ICBLLZ 
ICBLH:, X 
ICBLL.Z+1 
ICBLHZ 


2-7-79 PAGE 27 


; SUBTRACT FINAL LOW BYTE 
i AND SAVE BACK 
iGET HI BYTE 


GO INDIRECT TO A DEVICE HANDLER 
ON RETURN, N FLAG=1 IF ERROR ON RETURN 


#FNCNOT 
CIJUMP 
ICSTAZ 
#0 


iPREPARE NO FUNCTION STATUS FOR HANDLER RTS 
i#USE THE INDIRECT JUMP 

i SAVE STATUS 

i AND SET N FLAG 


i INDIRECT JUMP TO HANDLER BY PAUL.’S METHOD 


CIJUMP: 


TAX 
LDA 
PHA 
LDA 
PHA 
TXA 
LDBX 
RTS 


ICSPRZ+1 


ICSPRZ 


ICIDNO 


i SAVE A 

iGET JUMP ADDRESS HI BYTE 
iPUT ON STACK 

iGET JUMP ADDRESS LO BYTE 
iPUT ON STACK 

iRESTORE A 

iGET IOCB INDEX 

iGO TO HANDLER INDIRECTLY 


ERR LINE 


1146 
11467 
11468 
1149 
1170 
1171 
1172 
1173 
1174 
1175 
1176 
1177 
1178 
1179 
1180 
1181 
1182 
1183 
1184 
1185 
1186 
1187 
1188 
1189 
1190 
1191 
1192 
1193 
1194 
1195 
1196 
1197 
1198 
1199 
1200 
1201 


ADDR 


E69E 
E6A0 
E6A2 
EéA4 
E6AS 
ESA 
E6AB 
E6AC 


-EG6AD 


E6AE 


E&BO 
E4&B2 
E6B3 


E6B5 
E6B6 
E5B8 
E46éB9 
E6BB 
E46BD 
E6&BF 
E6C1 
E&C3 
E6C5 
E6C7 


E4C8 


Bi 


B2 BS B4 


O3 


CENTRAL INPUT/OUTPUT (CIO} 2-7-79 PAGE 


. PAGE 


DEVSRC: LBY 
LDA 
BEG 
LDY 
DEVS1t: CMP 
BEG 
DEY 
DEY 
DEY 
BPL 


i 


CIERR2: LDY 
SEC 


DEVSRC -- DEVICE SEARCH, FIND DEVICE IN HANDLER ADDRESS TABLE 


LOOP TO FIND DEVICE 


#0 
CICBALZ>),. Y i GET DEVICE NAME FROM USER 
CIERR2 


#MAXDEV i INITIAL COMPARE INDEX 
HATABS, Y iIS THIS THE DEVICE? 
DEVS2 i YES 


iELSE, POINT TO NEXT DEVICE NAME 


DEVS1 i CONTINUE FOR ALL DEVICES 
i NO DEVICE FOUND, DECLARE NON-EXISTENT DEVICE ERROR 
#NONDEV i ERROR CODE 
i SHOW ERROR 
DEVS4 i AND RETURN 


BCS 


i FOUND DEVICE. 
DEVS2: TYA 


DEVS3: STA 


i RETURN 
DEVS4: RTS 


SET ICHID. ICDNO, AND INIT DEVICE 


ICHIDZ i SAVE HANDLER INDEX 

#1 

(ICBALZ), Y iGET DEVICE NUMBER (DRIVE NUMBER) 
#ASCZER i SUBTRACT ASCII ZERO 

#SA i IS NUMBER IN RANGE? 

DEVS3 i YES 

#1 iNO, DEFAULT TO ONE 

ICDNOZ i SAVE DEVICE NUMBER 


i SHOW NO ERROR 
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ERR LINE 


1202 
1203 
1204 
1205 
1206 
1207 
1208 
1209 
1210 
1211 
1212 
1213 
1214 
1215 


ADDR 


Bi Be BS B4 


OG 04 04 04 
04 06 06 06 
0&4 C2 08 OA 


00 


CENTRAL INPUT/OUTPUT (CIO} 2-7-79 PAGE 


. PAGE 


CIO ROM TABLES 


COMMAND TABLE 
MAPS EACH COMMAND TO OFFSET FOR APPROPRIATE VECTOR IN HANDLER 
OMTAB: . BYTE 0. 4,4, 4,4,6,6,6,4,2,8,10 


oO ee ee ee ee ee Ty 


LENGTH =#-CIOINT 
CRNTPI = 
 #= $14 
CIOSPR: . BYTE INTORG-CRNTP1 i *GCIOL IS TOO LONG 


2 


> 


ERR LINE 


1216 
1217 
1218 
1219 
1220 
1221 
1222 
12293 
1224 
1225 
1226 
1227 
1228 
1229 
1230 
1231 
1232 
1233 
1234 
1235 
1236 
1237 
1238 
1239 
1240 
1241 
1242 
1243 
1244 
1245 
1246 
1247 
1248 
1249 
1250 
1251 
1252 
1253 
1254 


1255 


1256 
1257 
1258 
1259 
1240 


ADDR 


0006 


Bi B2 BS B4 


00 
00 


FF 


FF 


FF 


FF 


GO 
oo 


i 
i 


i 


CENTRAL INPUT/OUTPUT (CIO) 2-7-79 


. TITLE 


= & 


#=$E912 

JMP SETVBL 
=SETVBV 

JMP SETVBL 
JMP SYSVBL 
JMP XITVBL 

#=INTINV 

JMP THINIT 


PAGE 30 


‘INTERRUPT HANDLER ‘ 
iLIVES ON DK1i: INTHV. SRC 
SRTIM2 


i SECOND REPEAT INTERVAL 


THIS IS TO MAKE DOS 2 WORK WHICH USED AN ABSOLUTE ADDRESS 


#=VC TABL+ INTABS-VDSLST 


. WORD SYRTI 
. WORD SYIRGB 
. WORD SYIRGB 
. WORD SYIRGB 
. RES 8 

. WORD SYIRGB 
. WORD SYIRGB 
. WORD SYIRGB 
. WORD SYIRG 
. WORD 6,6,06,0,0 
. WORD SYSVBL 
. WORD XITVBL 
#=$900C 

LBA #P IRGH 
STA $FFFS 
LDA #P IRQL 
STA $FFFS 
LDA #PNMIH 
STA SFFFB 
LDA #PNMIL 
STA SFFFA 
RTS 


i VDSLST 
i VPRCED 
i VINTER 
i VBREAK 


iVTIMR1I 
iVTIMR2 
i VTIMR4 
i VIMIRG 
i CDTMV1-4 


i VVBLKI 
i VVBLKD 


i SET UP RAM VECTORS FOR LINBUG VERSION 


ERR LINE 


1261 
1262 
1263 
1264 
1265 
1266 
1267 
1268 
1269 
1270 
1271 
1272 
1273 
1274 
1275 
1276 
1277 


ADDR 


Bi 


B2 BS B4 


D4 


D3 
D3 


DS 
D3 


D3 
D3 


02 


EG 


INTERRUPT HANDLER 


a ee ee ee Te Ty 


IHINIT: 


PIRQ: 
CMPTAB: 


i THIS IS A TABLE OF OFFSETS INTO PAGE 2. 
BRAKY-INTABS 


ADRTAB: 


SYIRQ: 


SYIRG2: 


LOOPM: 


. PAGE 


IR@ HANDLER 


#=INTORG 


LBA 


. BYTE 
. BYTE 
. BYTE 
. BYTE 
. BYTE 
. BYTE 
. BYTE 
. BYTE 


PHA 
LDA 
AND 
BNE 
LDA 
STA 
LDA 
STA 
JMP 
TXA 
PHA 
LDX 
LBA 
CPX 


PAGE 31 


JUMP THRU IMMEDIATE IR@ VECTOR, WHICH ORDINARILY POINTS TO 
SYSTEM IRQ: DETERMINE & CLEAR CAUSE, 


JUMP THRU SOFTWARE VECTOR. 


iVBL. ON BUF DLIST OFF###FOR NOW### 
i ENABLE DISPLAY LIST. VERTICAL BLANK 
;LOOK AT DATA DIRECTION REGISTERS IN PIA 


iMAKE ALL INPUTS 


iBACK TO PORTS ‘ 


i BREAK KEY 

iKEY STROKE 

i TIMER 4 

i TIMER 2 

i TIMER 1 

; SERIAL OUT COMPLETE 
i SERIAL OUT READY 

i SERIAL IN READY 


THEY POINT TO 


VKEYBD-INTABS 
VTIMR4-INTABS 
VTIMR2-INTABS 
VTIMR1-INTABS 
VSEROC-INTABS 
VSEROR-INTAES 
VSER IN-INTABS 


IRGST 
#320 
SYIRG2 
#3DF 
IRGEN 
POKMSK 
IRGEN 
(VSERIN} 


#56 
CMP TAB, X 
#5 


i SAVE ACCUMULATOR 
i CHECK FOR SERIAL IN 


i MASK ALL OTHERS 


iPUT X INTO ACC 

i SAVE X ONTO STACK 

i START WITH SIX OFFSET 

;LOAD MASK 

iCHECK TO SEE IF COMPLETE IS SET 


ERR LINE 


1315 
1316 
1317 
1318 
1319 
1320 
1321 
1322 
13923 
1324 
1325 
1326 
1327 
1328 


1329 


1330 
1331 
1932 
1333 
1334 
1335 
1336 
1337 
1338 
1339 
1340 
1341 
1342 
1343 
1344 
1345 
1346 
1347 
1348 
1349 
1350 
1351 
1352 
1353 
1354 
1355 
1356 
1357 
1358 
1359 
1360 
1361 
1362 
1343 
1364 
1365 


ADDR 


E724 
E726 
E728 
E72A 
E72D 
E72F 
E730 
E732 
E735 
E737 
E73A 
E73C 
E73F 
E742 
E743 
E746 
E749 
E74C 


E74F 


E750 
E751 
E754 
E756 
E758 
E75B 


E75E 


E740 


£761 


E742 
E743 
E764 
E767 
E749 
E74&C 
E76F 
E772 
E774 
E777 
E77A 
E77B 
E77E 
E77F 
E780 
E782 
E784 
E787 
E788 
E78B 
E78E 
E78F 
E790 


BS B4 » 


D2 


02 
02 


INTERRUPT HANDLER 


LOOPMe2: 


LL: 


UMPR: 


BRKKY2: 


SYIRGS: 


SYIRQ?: 


SYIRQA: 


SYRTI2: 


SYIRGB: 


SYRTI: 


BNE 
AND 
BEG 
BIT 
BEG 
DEX 
BPL 
JMP 
EOR 
STA 
LDA 
STA 
LDA 
TAX 
LDA 
STA 
LDA 
STA 
PLA 
TAX 
JMP 
LDA 
STA 
STA 
STA 
STA 
PLA 
RTI 
PLA 
TAX 
BIT 
BPL 
LDA 
JMP 
BIT 
BPL 
LDA 
JMP 


LOOPM2 
POKMSK 
a 
IRGST 
JMPP 


LOOPM 
SYIR@S 
#SFF 
IRGEN 
POKMSK 
IRGEN 
ADRTAB, X 


INTABS, X 
JVECK 
INTABS+1, X 
JVECK+1 


(UIVECK } 


ATRACT 


PACTL 
SYIRG? 
PORTA 
(VPRCED} 
PBCTL 
SYIRGA 
PORTB 
(VINTER } 


JVECK 
#310 
SYRTI2 
JVECK 


(VBREAK > 
JVECK 


PAGE 


i#1S THIS INTERUPT ENABLED? 
i IS IT THE INTERUPT? 


iNO DEC X AND TRY NEXT MASK 
i IF NOT NEG GOTO LOOPM 
*DONE BUT NO INTERUPT 

i COMPLEMENT MASK 

iENABLE ALL OTHERS 

i GET POKE MASK 

i ENABLE THOSE IN POKE MASK 


GET ADDRESS LOW PART 

PUT IN VECTOR 

GET ADDRESS HIGH PART 

PUT IN VECTOR HIGH PART 
PULL X REGISTER FROM STACK 
PUT IT INTO X 

JUMP TO THE PROPER ROUTINE 
BREAK KEY ROUTINE 

SET BREAK KEY FLAG 
START/STOP FLAG 

CURSOR INHIBIT 

TURN OFF ATRACT MODE 


er ee eT Ta oy 


iEXIT FROM INT 


i+PROCEED ###I GUESS#44 
CLEAR INT STATUS BIT 
i INTERRUPT ###I GUESS #2 


iCLEAR INT STATUS 


iB BIT OF P REGISTER 


;+UNIDENTIFIED INTERRUPT, JUST RETURN. 


ERR LINE 


1366 
1367 
1348 
1369 
1376 
1371 
1372 
1373 
1374 
1375 
1376 
1377 
1378 
1379 
1380 
1381 
1382 
1383 
1384 
1385 


ADDR 


E791 
E794 
E796 
E799 
E79A 
E79D 
E79F 
E7A1 


E7A4 


E7AS 
E7A6 
E7A7 
E7AS8 
E7AB 


Bi 


Be 


OF 
22 


BS B4 


D4 
02 


INTERRUPT HANDLER 


. PAGE 


i 
i 
i 
; 
i 


PNMI: BIT 
BPL 
JMP 
PNMIi: PHA 
LDA 
AND 
BEG 
JMP 
TXA 
PHA 
TYA 
PHA 
STA 
JMP 


NMI HANDLER 


NMIST 
PNMI 1 
(VBSLST} 


NMIST 
#$26 
#+5 
WARMSV 


NMIRES 
(VVBLKTI} 


PAGE. 


DETERMINE CAUSE AND JUMP THRU VECTOR 


i SEE IF DISPLAY LIST 


i SEE IF RESET 


iGO THRU WARM START JUMP 
i SAVE REGISTERS 


;RESET INTERRUPT STATUS 
; JUMP THRU VECTOR 


33 


ERR LINE 


1386 
1387 
1388 
1389 
1390 
1991 
1392 
1393 
1394 
1395 
1396 
1397 
1398 
1399 
1400 
1401 
1402 
1403 
1404 
1405 
1406 
1407 
1408 
1409 
1410 
1411 
1412 
1413 
1414 
1415 
1416 
1417 
1418 


1419 . 


1420 
1421 
1422 
1423 
1424 
1425 
1426 
1427 
1428 
1429 
1430 
1431 
1432 
1433 
1434 
1435 
1436 
1437 
1438 
1439 


ADDR 


Bi 


B2 BS B4 


DO E8 


CA ES 


INTERRUPT HANDLER 


a ee ee ee ee Ty 


SYSVBL: 


SYSVB1: 


VBATRA: 


SYSVB2: 


XXIT: 
SYSVB3: 


SCOLLP: 


. PAGE 


SET DLISTL, 


INC 
BNE 
INC 
INC 
BNE 
INC 
LDA 
L.DX 
LDY 
BPL 
STA 
LDX 
LBA 
STA 
STX 
LDX 
JSR 
BNE 
JSR 
LDA 
BNE 
TSX 


LDA 


AND 
BEG 
JMP 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDX 
STX 
CLI 
LDA 
EOR 
AND 
STA 
DEX 
BPL 


DLISTH, 


SYSTEM VBLANK ROUTINE 


RTCLOK+2 
SYSVBi 
ATRACT 
RTCLOK+1 
SYSVB1 


#EF6 


CONSOL 


PCOLRG, X 
COLRSH 
DRAMSK 
COLPMO, X 


SCOLLP 


PAGE 34 


INC FRAME COUNTER. PROCESS COUNTDOWN TIMERS. EXIT IF I WAS SET, CLEAR 
DMACTL FROM RAM CELLS. DO SOFTWARE REPEAT. 


i INC FRAME COUNTER 


i INCREMENT ATRACT (CAUSES ATRACT WHEN MINUS) 


i fATRACT] SET DARK MASK TO NORMAL 

i SET COLRSH TO NORMAL 

i TEST ATRACT FOR NEGATIVE 

iWHILE POSITIVE, BONT GO INTO ATRACT 
i IN ATTRACT, SO STAY BY STA $FE 

; COLOR SHIFT FOLLOWS RTCLOK+1 

i SET BARK MASK TO DARK 


*>POINT TO TIMERI 

iGO DECREMENT TIMERI 

i BRANCH IF STILL COUNTING 
iGO JUMP TO ROUTINE 


iGO IF CRITICAL SET 
;SEE IF I WAS SET 
iGET STACKED P 


iI BIT 
i BRANCH IF OK 
iI WAS SET, EXIT 


iGLOBAL PRIOR 
i TURN OFF KEYBOARD SPEAKER 


i DISABLE INTERRUPTS 

iLOAD COLOR REGISTERS FROM RAM 
i DO COLOR SHIFT 

i AND DARK ATRACT 


ERR LINE 


1440 
1441 
1442 
1443 
1444 
1445 
1446 
1447 
1448 
1449 
1450 
1451 
1452 
1453 
1454 
1455 
1456 
1457 
1458 
1459 
14640 
1461 
1462 
1463 
1444 
1465 
1466 
1467 
1468 
1469 
1470 
1471 
1472 
1473 
1474 
1475 
1476 
1477 
1478 
1479 
1480 
1481 
1482 
1483 
1484 
1485 
1486 
1487 
1488 
1489 
1490 
1491 
1492 
1493 


00 


78 


ES 


02 
02 


= 
02 


D2 


DS 


02 


B3 


02 


INTERRUPT HANDLER 


raven 


iPOINT TO TIMER 2 


i IF DIDNT GO ZERO 
iGO JUMP TO TIMER2 ROUTINE 
*#RESTORE X 


iDECREMENT AND SET FLAG IF NONZERO 


iSEE IF DONE ALL 3 
i LOOP 


iKEY DOWN BIT 
i IF KEY DOWN 


iKEY DELAY COUNTER 
i IF COUNTED DOWN ALREADY 
; COUNT IT 


iDOESN‘’T COUNT 


i CHECK KEY DOWN BIT 
iBRANCH IF NO LONGER DOWN 
i COUNT FRAME OF KEY DOWN 
i BRANCH IF NOT RUN OUT 
SIMULATE KEYBOARD IRG 

i TIMER VALUE 

iSET TIMER 

iGET THE KEY 

iPUT INTO CH 


i STORE JOYSTICK 


i STORE JOYSTICK 


LDA CHBAS 
STA CHBASE 
LDA CHACT 
STA CHACTL 
LDX #2 
JSR DCTIMR 
BNE SYSVB4 
JSR JTIMR2 
SYSVB4: LDX #2 
SYSVBB: INX 
INX 
LDA CDTMV1, X 
ORA CBDIMViti, X 
BEQ SYSVBA 
JSR DCTIMR 
STA CDIMF3-4, X 
SYSVBA: CPX #5 
BNE SYSVBB 
i CHECK DEBOUNCE COUNTER 
LDA SKSTAT 
AND #404 
BEG SYVBSA 
i KEY UP SO COUNT IT 
LDA KEYDEL 
BEG SYVB6A 
BEC KEYDEL 
i CHECK SOFTWARE REPEAT TIMER 
SYVBG6A: LDA SRTIMR 
BEG SYSVB7 
LDA SKSTAT 
AND #404 
BNE SYSVB6 
DEC SRTIMR 
BNE SYSVB7 
i TIMER RAN OUT - RESET AND 
LDA #SRTIM2 
STA SRTIMR 
LDA KBCODE 
STA CH 
i READ GAME CONTROLLERS 
SYSVB7: LBY #1 
LDX #3 
STLOOP: LDA PORTA. Y 
LSR 4 
LSR A 
LSR &é 
LSR A 
STA STICKO, X 
DEX 
LDA PORTA, Y 
AND #3F 
STA STICKO. X 
DEX 


DEY 


ERR LINE 


1494 
1495 
1496 
1497 
1498 
1499 
1500 
1501 
1502 
1503 
1504 
1505 
1506 
1507 
1508 
1509 

£510 
1Si4 
1512 
1513 
1514 
1515 
1516 
1517 
1518 
1519 
1520 
1521 
1522 
1523 
1524 
1525 
1526 
1527 
1528 

1529 
1530 
1531 
1532 
1533 
1534 
1535 
1536 
1537 
1538 
1539 
1540 
1541 
1542 
1543 
1544 
1545 
1546 
1547 


ADDR 
E8sc 


ESSE 
E890 
EG93 
E896 
E899 
ES9C 
EG9F 
EBA2 
EB8A3 
ESAS 


ESA8 
EGAA 
ESAC 
ESAF 
ESBO 
ESB1 
ESB2 
ESBS 
E8B7 
ESBS 
ESBB 
ESBC 
ESBD 
ESBE 


ESCO 
OOE8 
0073 
ES8Cc3 
E8CS 
ESCs 
ESCA 
EScD 


ESDO 
E8D3 
ESDS 
E8Ds 
ESDA 
ESDD 
ESEO 
ESE2 
ESES 
ESE7 
EGE? 
ESEA 
ESEC 


BS B4 


02 


02 


02 


02 


02 
02 


02 
02 


02 


02 


02 


INTERRUPT HANDLER 


BPL STLOOP 
L.DX #3 
STRL: LDA TRIGG, X 
STA STRIGG, X 
LDA POTG, X 
STA PADDLO, X 
LDA POT4, X 
STA PADBL4, X 
DEX 
BPL STRL 
STA POTGO 
LDX #4 
LDY #3 
PTRLP: LDA STICKG., Y 
LSR & 
LSR A 
LSR 4 
STA PTRIGI, X 
LDA #0 
ROL A 
STA PTRIGO, X 
DEX 
DEX 
DEY 
BPL PTRLUP 
JMP (VVBLKD > 
SV7H = SYSVB7/256 
SV7L = 
SYSVB&: LDA #0 
STA SRTIMR 
BEG SYSVB7 
JTIMRi? JMP (CDTMAI > 
JMP (CDTMA2} 


JTIMR2: 


PAGE 


iMOVE JOYSTICK TRIGGERS 


iMOVE POT VALUES 


iSTART POTS FOR NEXT TIME 


i TRANSFER BITS FROM JOYSTICKS 
i TQ PADDLE TRIGGERS 


iGO TO DEFERRED VBLANK ROUTINE 


(-256) #SV7H+SYSVB7 


i ZERO TIMER 
; UNCOND 


SUBROUTINE TO DECREMENT A COUNTDOWN TIMER 
ENTRY X=OFFSET FROM TIMER 1 


EXIT A, P=ZERO IF WENT ZERO, 


DCTIMR: 


LDY CDIMV1, X 
BNE DCTIM1 
LDY CDTMVi+1i, X 
BEG DCTXF 
DEC CDIMVi+ti, X 
DCTIM1: DEC CDIMVI, X 
BNE BCT XF 
LDY CDTMV1it+i, X 
BNE DCTXF 
LDA #0 
RTS 
DCTXF: LDA #3FF 
RTS 


FF OTHERWISE 


iLO BYTE 

iNONZERO, GO DEC IT 
iSEE IF BOTH ZERO 
*YES, EXIT NONZERO 
i+ DEC HI BYTE 

*DEC LO BYTE 


iWENT ZERO, RETURN ZERO 


iRETURN NONZERO 


34 


ERR LINE 


1548 
1549 
1550 
1551 
1552 
1553 
1554 
1555 
1556 
1557 
1558 
1559 
1560 
1561 
1562 
1543 
1564 
1565 
1566 
1547 
1548 
1569 
1570 
i571 
1572 
1573 
1574 
1575 
1576 
1577 
1578 
1579 
1580 
1581 
1582 
1583 
1584 


ADDR 


ESED 
ESEE 
EGF i 
EeF2 
EGF4 
ESF 7 
Ears 
ESFA 
ESFD 
E900 
ESOL 
E904 


E905 
E906 
E907 
E908 
E909 
EPOA 
QOOES 
OOF3 
OOE7 
0091 


E9OB 


0014 


Bi Be BS B4 


39 


2D 


OS 
OA 


FD 
2D 
17 


16 


02 


B4 


02 
02 


02 


INTERRUPT HANDLER PAGE 


i A= 
SETVBL: ASL 
STA 
TXA 
LDX 
STA 
SETLOP: BEX 
BNE 
L.DX 
STA 
TYA 
STA 
RTS 
i; EXIT FROM 
XITVBL: PLA 
TAY 
PLA 
TAX 
PLA 
RTI 
PIRQH = 
PIRQL = 
PNMIH = 
PNMIL = 
i SPARE BYTE OR 
CRNTP2 = 
x=$14 
INTSPR: . BYTE 


. PAGE 


SUBROUTINE TO SET VERTICAL BLANK VECTORS AND TIMERS 
ENTRY X=HI, Y=LO BYTE TO SET 

1-53 TIMERS i-S 

& IMM VBLANK 

7 DEF VBLANK 


& i;MUL BY 2 
INTEMP 
#5 
WSYNC iWASTE 20 CPU CYCLES 
i TO ALOWD VBLANK TO HAPPEN 
SETLOP i IF THIS IS LINE "7C" 
INTEMP 
CDIMVi-i, X 
CDTMV1i-2, X 


VERTICAL BLANK 


iUNSTACK Y 

i UNSTACK X 

i UNSTACK A 

i AND GO BACK FROM WHENCE. 
PIRG/256 
(-256)}#P IRGH+PIRG 
PNMI/256 


(-256) #PNMIH+PNMI 
MODULE TOO LONG FLAG 


SIODORG-CRNTP2 i *GINTHV IS TOO LONG 


37 


ERR LINE ADDR Bi Be BS B4 INTERRUPT HANDLER 4 PAGE 38 


i585 

1586 . TITLE ‘SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER }‘ 
1587 i COLLEEN OPERATING SYSTEM 

1588 i 

1589 i SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) 

1590 i WITH SOFTWARE BAUD RATE CORRECTION ON CASSETTE 

1591 i 

i892 i 

1593 i AL MILLER 3-APR-79 

1594 i 

1595 i 

1596 i THIS MODULE HAS ONE ENTRY POINT. IT IS CALLED BY THE DEVICE 
1597 i HANDLERS. IT INTERPRETS A PREVIOUSLY ESTABLISHED DEVICE CONTROL 
1598 i BLOCK (STORED IN GLOBAL. RAM) TO ISSUE COMMANDS 

1899 i; TO THE SERIAL BUS TO CONTROL TRANSMITTING AND RECEIVING DATA. 
1400 i 

1601 i 

1402 ; 


1603 


ERR LINE 


1604 
1605 
1406 
1607 
1608 
1409 
1410 
1611 


ADDR 


0030 


0060 


0052 
0057 


0053 
O04E 
0044 
0050 


0041 
OO4E 
0043 
0045 


0028 
0000 
oocc 
0005 
0005 
0007 


OOB4 
0078 
OOOF 
OOOA 


Bi Be BS B4 


ERROR 


a 


i 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER > PAGE 39 
. PAGE 

i EQUATES 

+ DCD DEVICE BUS ID NUMBERS 

FLOPPY = $30 

#PRINTR = $40 

i CASSET = $60 bP EEL t sass 

CASET = $60 PP PEEL seeesesece 

+ BUS COMMANDS 

READ = ‘R 

WRITE = W 

iSTATIS = 'S 

i FORMAT = ‘3 

i COMMAND AUX BYTES 

SIDWAY = ‘Ss iPRINT 16 CHARACTERS SIDEWAYS 

NORMAL = “N iPRINT 40 CHARACTERS NORMALLY 

DOUBLE = ‘BR iPRINT 20 CHARACTERS DOUBLE WIDE 

PLOT = ‘Pp ;PLOT MODE 

i BUS RESPONSES 

ACK = ‘A iDEVICE ACKNOWLEDGES INFORMATION 

NACK = ‘N iDEVICE DID NOT UNDERSTAND 

COMPLT = “Cc *+DEVICE SUCCESSFULLY COMPLETED OPERATION 
= ‘Ee iDEVICE INCURRED AN ERROR IN AN ATTEMPTED OP 


i MISCELLANEOUS EQUATES 


B19?2L0 
B1i92HI 
B46&00L0 
B600HI 
HI TONE 
LOTONE 


a 


WIRGLO 
RIRGLO 
WSIRG 
RSIRG 


WIRGLO 
RIRGLO 
WSIRG 
RSIRG 


Hoiuouw ho wow 


IF 


how uo it 


. ENDIF 


Hou W ne 


$28 i 19200 BAUD RATE POKEY COUNTER VALUES (LO BY 
$00 i (HI BYTE) 
$CC i600 BAUD (LO BYTE) 
$05 i (HI BYTE) 
$05 iFSK HI FREQ POKEY COUNTE VALUE (5326 HZ) 
$07 iFSK LO FREQ POKEY COUNTER VALUE (3995 HZ) 
PALFLG 
150 iWRITE INTER RECORD GAP CIN 1/760 SEC) 
100 iREAD INTER RECORD GAP (IN 1/60 SEC? 
13 i SHORT WRITE INTER RECORD GAP 
8 i SHORT READ INTER RECORD GAP 
PALFLG-1 
180 iWRITE INTER RECORD GAP (IN 1/60 SEC) 
120 iREAD INTER RECORD GAP (CIN 1/40 SEC> 
15 i SHORT WRITE INTER RECORD GAP 


10 i SHORT READ INTER RECORD GAP 


ERR LINE 


1658 
1659 
1640 
1661 
1462 
1463 
1664 
1665 
1666 
1467 
1468 
1669 
1470 
1471 
1672 
1473 
1674 
1675 
1676 
1677 
1478 
1479 
1680 


ADDR 


00006 
0000 


0034 
003C 
0034 
003C 


0002 
O003E 
0002 
003A 


O0OD 
0001 
0002 
0000 


Bi Be BS B4 


SiO (€ SERIAL BUS INPUT/OUTPUT CONTROLLER }) _ PAGE 
. ENDIF 
WIRGHI = 0 
RIRGHI = 0 
NCOMLO = $34 iPIA COMMAND TO LOWER NOT COMMAND LINE 
NCOMHI = $3C iPTA COMMAND TO RAISE NOT COMMAND LINE 
MOTRGO = $34 iPIA COMMAND TO TURN ON CASSETTE MOTOR 
MOTRST = $3C ;PIA COMMAND TO TURN OFF MOTOR 
TEMPHI = TEMP /254 i ADDRESS OF TEMP CELL (HI BYTE) 
TEMPLO = (-256) 4TEMPHI+TEMP i (LO BYTE) 
CBUFHI = CDEVIC/256 iADDRESS OF COMMAND BUFFER (HI BYTE) 
CBUFLO = (-256)#CBUFHI+CDEVIC i; (LO BYTE} 
CRETRI = 13 iNUMBER OF COMMAND FRAME RETRIES 
DRETRI = 1 iNUMBER OF DEVICE RETRIES 
CTIMLO = 2 i COMMAND FRAME ACK TIME OUT (LO BYTE) 
CTIMHI = ce] i COMMAND FRAME ACK TIME OUT CHI BYTE? 
+#JTADRH = JTIMER/256 *+HI BYTE OF JUMP TIMER ROUTINE ADDR 
= (-256 } #JTADRH+JUTIMER i"MOVED TO LINE 1428" 


i JTADRL 


e 


40 


iy 


ERR LINE 


1681 
1682 
1683 
1684 
14685 
1486 
1687 
14688 
1689 
1490 
1491 
1692 
1693 
1694 
1495 
1496 
1497 
1698 
1499 
1700 
1701 
1702 
1703 
1704 
1705 
1706 
1707 
1708 
1709 
1710 
1741 
1712 
1713 
1714 
1715 
1716 
1717 
1718 
1719 
1720 
1721 
1722 
1723 
1724 
1725 
1726 
1727 
1728 
1729 
1730 
1731 
1732 
1733 
1734 


ADDR 


E459 


E465 


E448 


E4BA 
E48C 
E4B6E 


EP44 
EP?46 


E949 
E94B 


E94E 
ESO 
E953 
E955 


E958 


E?S9? 
ESA 
ESD 
E9SF 


E?61 
E964 
E966 
E68 


Bi 


ac 


4¢ 


OF 


CF 


a? 
8D 


B2 


59 


44 


EB 


EA 


ac 
02 


BS B4 


EF 


E? 


EB 


D3 


DS 


02 


D2 


03 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER >} PAGE 


me 


i 


. PAGE 
$10 


#=SIOV 
JMP Si iSIO ENTRY POINT 
#=SIOINV 
JMP SIOINT iSIO INITIALIZATION ENTRY POINT 
#+=SENDEV 
JMP SENDEN i SEND ENABLE ENTRY POINT 


#=VCTABL-INTABS+VSERIN 


. WORD ISRSIR i VSERIN 
. WORD ISRODN i VSEROR 
. WORD ISRTB i VSEROC 
#=S IOORG 


i SIO INITIALIZATION SUBROUTINE 


SIOINT: 


LDA #MOTRST 

STA PACTL i TURN OFF MOTOR 

LDA #NCOMHI 

STA PBCTL iRAISE NOT COMMAND LINE 

LDA #3 

STA SSKCTL. iGET POKEY OUT OF INITIALIZE MODE 
STA SOUNDR i INIT POKE ADDRESS FOR QUIET 1/0 
STA SKCTL 

RTS i RETURN 

TSX 

STX STACKP iSAVE STACK POINTER 

LDA #1 

STA CRITIC 

LDA DDEVIC 

CMP #CASET 

BNE NOTCST i BRANCH IF NOT CASSETTE 

JMP CASENT i OTHERWISE JUMP TO CASSETTE ENTER 


Ai 


ERR LINE 


1735 
1736 
1737 
1738 
1739 
1740 
1741 
1742 
1743 
1744 
1745 
1746 
1747 
1748 
1749 
1750 
1751 
1752 
1753 
1754 
1755 
1756 
1757 
1758 
1759 
1760 
1741 
1762 
1763 
1764 
1745 
1766 
1747 
1768 
1749 
1770 
1771 
1772 
1773 
1774 
1775 
1776 
1777 
1778 
1779 
1780 
1781 
1782 
1783 
1784 
1785 
1786 
1787 
1788 


ADDR 


E94B 
E?4D 


E970 
E972 
E974 
E?76 


E978 
EV7A 
E97D 
ES7F 


E982 
E983 
E984 
E989 
E98B 


ESE 
E991 


EG94 
E997 
EPA 
E?9D 


EPAO 
EAI 
ESAS 
EQAS 
EPA7 
EGA? 
EAB 
EAD 


EGAF 
E?B1 


E?B4 


EVB7 
ESBA 


ESBC 
E?BD 


E?BF 


Bt 


B2 BS B4 


07 


36 


03 


D3 


EC 


02 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) 


i 


PAGE 42 


; ALL DEVICES EXCEPT CASSETTE ARE INTELLIGENT 


NOTCST: 


COMMND: 


; 


LDA 
STA 


LDA 
STA 
LDA 
STA 


#0 
CASFLG 


#DRETRI 
DRETRY 
#CRETRI 
CRETRY 


i SEND A COMMAND FRAME 


COMFRM: 


; 


BADCOM: 


LDA 
STA 
LDA 
STA 


CLC 
LBA 
ADC 
ADC 
STA 


LDA 


STA 


LDA 
STA 
LDA 
STA 


CLC 
LDA 
STA 
ADC 
STA 
LDA 
STA 
STA 


LDA 
STA 


JSR 


LDA 
BNE 


TYA 
BNE 


DEC 


#B192L0 
AUDF3 
€#Bi92HI 
AUDF4 


DDEVIC 
DUNIT 
#$FF 
CDEVIC 


DCOMND 
CCOMND 


DAUX 1 
CAUX I 


DAUX2 
CAUX2 


#CBUFLO 


BFENHI 


#NCOMLO 
PBCTL 


SENDIN 
ERRFLG 
BADCOM 


ACKREC 


CRETRY 


i INIT CASSETTE FLAG TO NO CASSETTE 
;SET NUMBER OF DEVICE RETRIES 


i SET NUMBER OF COMMAND FRAME RETRIES 


iSET BAUD RATE TO 19200 


i SET UP COMMAND BUFFER 


i SUBTRACT i 
iSET BUS ID NUMBER 


iSET BUS COMMAND 


; STORE COMMAND FRAME AUX BYTES 1 AND 2 


i DONE SETTING UP COMMAND BUFFER 
i SET BUFFER POINTER TO COMMAND FRAME BUFFER 


i AND BUFFER END ADDRESS 


i DONE SETTING UP BUFFER POINTER 


i LOWER NOT COMMAND LINE 

i SEND THE COMMAND FRAME TO A SMART DEVICE 
i BRANCH IF AN ERROR RECEIVED 

iBRANCH IF ACK RECEIVED 


i& NACK OR TIME OUT OCCURED 


ERR LINE ADDR Bi Be B3 B4 SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER >) PAGE 43 


1789 E9CI 1G BS BPL . COMFRM iSO BRANCH IF ANY RETRIES LEFT 
1790 i 

1791 E9C3 4C O06 EA JMP DERR1 i; OTHERWISE. JUMP TO RETURN SECTION 
1792) 3 

1793 i 

1794 E9C6& AD O3 C3 ACKREC: LDA DSTATS i} ACK WAS RECEIVED 

1795 €9C9 16 0C¢C BPL WATCOM i BRANCH TO WAIT FOR COMPLETE , 
1796 i IF THERE IS NO BATA TO BE SENT 

1797 i 

1798 i 

1799 ; 

1800 i SEND A DATA FRAME TO PERIPHERAL 

1801 i 

1802 E9CB AS OD LDA #CRETRI i; SET NUMBER OF RETRIES 

18603 E9CD 85 364 STA _CRETRY 

1804 ; 

1805 E9CF 26 6A EB JSR LDPNTR iLOAD BUFFER POINTER WITH DCB INFORMATION 
1806 i 

1807 E9D2 20 BA EC JSR SENDIN iGO SEND THE DATA FRAME TO A SMART DEVICE 
1808 i 

1809 E9D5 FO ES&S BEG BADCOM i BRANCH IF BAD 

1810 i 

isil i 

1812 i 

1813 i WAIT FOR COMPLETE SIGNAL FROM PERIPHERAL 

1914 i 

1815 E9D7 20 75 EC WATCOM: JSR STTMOT i SET DDEVICE TIME OUT VALUES IN Y, X 
1816 i 

1817 E9DA Ag? 0O LDA #$00 

iG@i8 E?9DC 8D 3F C2 STA ERRFLG i CLEAR ERROR FLAG 

1819 i 

1820 E?DF 20 98 EC JSR WAITER iSET UP TIMER AND WAIT 

1821 E?E2 FO 12 BEG DERR i BRANCH IF TIME OUT 

1822 i 

1823 i 

1824 i; DEVICE DID NOT TIME OUT 

1825 i 

1626 E9E4 2C 03 03 BIT DSTATS 

1827 ESE7 76 07 BYS MODATA i BRANCH IF MORE DATA FOLLOWS 
1828 i 

1829 E9E9 AD 3F 02 LDA ERRFLG 

1830 ESEC BO 18 BNE DERRi i BRANCH IF AN ERROR OCCURRED 
1831 ESEE FO 1B BEG RETURN | i; OTHERWISE RETURN 

1832 i 

1833 i 

1834 i 

1835 4 

1836 >; RECEIVE A DATA FRAME FROM PERIPHERAL 

1837 i 

18638 E9FO 20 6A EB ODATA: JSR LDPNTR i LOAD BUFFER POINTER WITH DCB INFORMATION 
1839 i 

1840 ESF3 20 EC EA JSR RECEIV iGO RECEIVE A DATA FRAME 

1841 


1842 E9F6& AD SF C2 DERR: LDA ERRFLG 


ERR LINE 


1843 
1844 
1845 
1846 
1847 
1848 
1849 
1850 
1851 
1952 
1853 
1854 
1855 
1856 
1857 
1858 
1859 
1840 
1861 
18642 
1843 
1864 
1865 
1866 
1867 
1868 
1849 
1870 
1871 
1872 
1873 
1874 
1875 
1876 
1877 
1878 
1879 
1880 
19881 
1882 
1883 
1884 
1885 
1886 
1887 
1888 
1889 
1890 
1891 
1892 
1893 
19894 
1895 
1896 


ADDR 
EDF? 


ESFB 
ESFE 


EA00 
EAG2 
EAO4 


EAO6 
EA08 


EAOA 


EAOD 
EA1O 
EAi2 
EA14 
EALG 
EA19 


EALA 
EAIC 


EAIF 
EA2O 
EA22 
EA24 
EA26 
EA28 
EA2ZA 
EA2C 


EAZE 
EAS3O 


EAS2 


EASS 
EA37 
EA39 
EASB 


Bi 


FG 


Be BS B4 


O5 


E? 


02 


EA 


SIO ( SERIAL BUS INPUT/OQUTPUT CONTROLLER > PAGE 


i 


NOTERR: 


DERR1: 


RETURN: 


WAITS FOR COMPLETE OR ACK 


BEG 


LDA 
STA 


LBA 
CMP 
BEG 


DEC 
BMI 


JMP 


JSR 
LDA 
STA 
LDY 
STY 
RTS 


NOTERR 
TSTAT 
STATUS 


STATUS 
#SUCCES 
RETURN 


BRETRY 
RETURN 


COMMND 


SENDDS 


RETURN 


i WAIT SUBROUTINE 


i#BRANCH IF NO ERROR PRECEEDED DATA 


iGET TEMP STATUS 


iSTORE IN REAL STATUS 


i BRANCH IF COMPLETELY SUCCESSFUL 


iBRANCH IF OUT OF DEVICE RETRIES 


i OTHERWISE, ONE MORE TIME 


i DISABLE POKEY INTERRUPTS 


;RETURN STATUS IN Y 
i AND THE DCB STATUS WORD 


RETURNS Y=$FF IF SUCCESSFUL, Y=$00 IF NOT 


WAIT: 


LDA 
STA 


CLC 
LDA 
STA 
ADC 
STA 
LDA 
STA 
STA 


LDA 


STA 


JSR 


LDY 
LDA 
CMP 
BNE 


#300 
ERRFLG 


#TEMPLO 
BUFRLO 


#TEMPHI 
BUFRHI 
BFENHI 


#SFF 
NOCKSM 


RECEIV 


#$FF 
STATUS 
#SUCCES 
NWOK 


i CLEAR ERROR FLAG 


iLOAD BUFFER POINTER WITH ADDRESS 


iOF TEMPORARY RAM CELL 


iALSO SET BUFFER END +1 ADDRESS 


i DONE LOADING POINTER 


i SET NO CHECKSUM FOLLOWS DATA FLAG 
iGO RECEIVE A BYTE 


i ASSUME SUCCESS 


i BRANCH IF IT DID NOT WORK OK 


44 


ERR LINE 


1897 
1898 
1899 
1900 
1901 
1902 
1903 
1904 
1905 
1906 
1907 
1908 
1909 
1910 
1911 
1912 
1913 
1914 
1915 
1916 
1917 
1918 
1919 
1920 
1921 
1922 
1923 
1924 
1925 
1926 
1927 
1928 
1929 
1930 
1931 
1932 
1933 
1934 
1935 
1936 
1937 
1938 
1939 
1940 
1941 
1942 
1943 
1944 
1945 
1946 
1947 
1948 
1949 
1950 


ADDR 


EAD 
EA40 
EA42 
EA44 
EA46 


EA48 
EA4A 


EA4aC 
EA4E 
EASO 


EAS2 
EAS4 


EAS6 
EASS 
EASA 


EASC 
EASE 
EAS1 


EAS 


EA6S 
EAG7 
EAGA 


EA&B 
EA6éD 


EAGF 


EA72 
EA74 
EA76 
EA78 


Bi 


Be BS B4 


03 


EB 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER > PAGE 43 


meee ee 


NOTDER: 


NWOK: 


LDA TEMP iMAKE SURE THE BYTE SUCCESSFULLY RECEIVED 

CMP #ACK iWAS ACTUALLY AN ACK OR COMPLETE 

BEG GOOD 

CMP #COMPLT 

BEG GOob 

CMP #ERROR 

BNE NOTDER i BRANCH IF DEVICE DID NOT SEND BACK 
i A DEVICE ERROR CODE 

LDA #DERROR 

STA STATUS i SET DEVICE ERROR STATUS 

BNE NWOK 

LDA #DNACK i OTHERWISE SET NACK STATUS 

STA STATUS 

LDA STATUS 

CMP €#TIMOUT 

BEG BAB iBRANCH IF TIME OUT 

LDA #$FF 

STA ERRFLG i SET SOME ERROR FLAG 

BNE GOOD #RETURN WITH OUT SETTING Y = 0 

LDBY #0 

LDA STATUS 

STA TSTAT 

RTS i RETURN 


ee eS Te 


SEND: 


LDA 
STA 
JSR 
LDY 
STY 


STY 
STY 


SEND SUBROUTINE 


SENDS A BUFFER OF BYTES OUT OVER THE SERIAL BUS 


#SUCCES i; ASSUME SUCCESS 

STATUS 

SENDEN i ENABLE SENDING 

#0 

CHKSUM i CLEAR CHECK SUM 
CHASNT i CHECKSUM SENT FLAG 
XMTDON i TRANSMISSION DONE FLAG 


ERR LINE 


1951 
1952 
1953 
1954 
1955 
1956 
1957 
1958 
1959 
1960 
1961 
1962 
1963 
1964 
1945 
1966 
1967 
1968 
1949 
1970 
1971 
1972 
1973 
1974 
1975 
1976 
1977 
1978 
1979 
1980 
1981 
1982 
1983 
1984 
1985 
1986 
1987 
1988 
1989 
1990 
1991 
1992 
1993 
1994 
1995 
1996 
1997 
1998 
1999 
2000 


2001 


2002 
2003 
2004 


ADDR 


EA7A 
EA7C 


EA7F 


EAS81 
EA83 
EAS8S 


EA88 
EABA 


EABC 


EASF 


EAI0 
EAQ1 


EAG2 
EA94 
EA9G6 


EA98 
EAPA 
EA9C 
EASE 
EAAO 


EAA] 
EAA4 


EAAG 
EAAS 
EAAB 
EAAD 
EAAF 


EABI 
EABS 
EABS 
EAB7 


EABA 
EABB 
EABC 


B2 BS B4 


OD D2 


AQ ED 


SF EC 


OB D2 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) PAGE 


LDA 
STA 
STA 
NOTDON: LDA 
BNE 
JMP 


NTBRKO: LDA 
BEG 


JSR 


RTS 


Or a 


SRODN: TYA 
PHA 


INC 
BNE 
INC 


NOWRPO: LDA 
CMP 
LDA 
SBC 
BCC 


LDA 
BNE 


LDA 
STA 
LDA 
STA 
BNE 


RELONE: LDA 
DRA 
STA 
STA 


CHKDON: PLA 


TAY 
PLA 


(BUFRLO?}, Y 


SEROUT 


CHKSUM 


BRKKEY 
NTBRKG 
BROKE 


XMTDON 
NOTDON 


SENDDS 


BUFRLO 
NOWRPO 
BUFRHI 


BUFRLO 
BFENLO 
BUFRHI 
BFENHI 
NOTEND 


CHKSNT 
RELONE 


CHKSUM 
SEROUT 
#$FF 

CHKSNT 
CHKDON 


POKMSK 
#$08 
POKMSK 
IRGEN 


;PUT FIRST BYTE FROM BUFFER 
i INTO THE SERIAL OUTPUT REGISTER 


iPUT IT IN CHECKSUM 


; JUMP IF BREAK KEY PRESSED 


;LOOP UNTIL TRANSMISSION IS DONE 


i DISABLE SENDING 


i RETURN 


QUTPUT BATA NEEDED INTERRUPT SERVICE ROUTINE 


iSAVE Y REG ON STACK 


i INCREMENT BUFFER POINTER 


i CHECK IF PAST END OF BUFFER 
iHIGH PART 


i BRANCH IF NOT PAST END OF. BUFFER 
i BRANCH IF CHECKSUM ALREADY SENT 


i; SEND CHECK SUM 


i SET CHECKSUM SENT FLAG 


i ENABLE TRANSMIT DONE INTERRUPT 


iRESTORE Y REG 
*#RETURN FROM INTERRUPT 


46 


ERR LINE 


2005 
2006 
2007 
2008 
2009 
2010 
2011 
2012 
2013 
2014 
2015 
26016 
2017 
2018 
2019 
2020 
2021 
2022 
2023 
2024 
2025 
2026 
2027 
2028 
2029 
2030 
2031 
2032 
2033 
2034 
2035 
2036 
2037 
2038 
2039 
2040 
2041 
2042 
2043 
2044 
2045 
2046 
2047 
2048 
2049 
2050 
2051 
2052 
2053 
2054 
2055 
2056 
2057 
2058 


ADDR 


EABD 


EABE 
EACO 
EAC2 


EACS 
EACS 
EACS 
EACA 


EACC 


EACF 
EAD1 


EADS 


EADS 
EAD7 
EADS 
EADB 


EADE 
EADF 


EAEO 


EAE2 
EAES 


EAE7 
EAE9 
EAEB 


Be BS B4 


De 


EA 


D2 


03 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER > PAGE 
RTI 
NOTEND: LDY #0 
LDA (BUFRLO}, Y iPUT NEXT BYTE FROM BUFFER 
STA SEROUT i INTO THE SERIAL OUTPUT REGISTER 
CLC iADD IT TO CHECKSUM 
ABC CHKSUM 
ADC #0 
STA CHKSUM 
JMP CHKDON iGO RETURN 


i TRANSMIT DONE 
I 


SRTD: LDA 
BEG 


STA 


FOQOEY: PLA 


es ian ee Te Te ee ee Se Td 


ECEIV: LDA 


~ 


LDY 
BNE 


STA 
NOCLR: STA 
STA 


INTERRUPT SERVICE ROUTINE 


CHKSNT 
FOOEY i BRANCH IF CHECKSUM NOT YET SENT 


XMTDON i OTHERWISE SET TRANSMISSION DONE FLAG 
POKMSK iDISABLE TRANSMIT BONE INTERRUPT 

#SF7 

POKMSK 

IRGEN 


; RETURN FROM INTERRUPT 


RECEIVE SUBROUTINE 


#0 

CASFLG 

NOCLR i BRANCH IF CASSETTE 
CHKSUM i CLEAR CHKSUM 
BUFRFL iBUFFER FULL FLAG 
RECVDN iRECEIVE DONE FLAG 


47 


ERR LINE 


2059 
2060 
2061 
2062 
2063 
2064 
2065 
2066 
2067 
2048 

2069 
2070 
2071 
2072 
2073 
2074 
2075 
2076 
2077 
2078 
2079 
2080 
2081 
2082 
2083 
2084 
2085 
2086 
2087 
2088 
2089 
2090 
2091 
2092 
2093 
2094 
2095 
2096 
2097 
2098 
2099 
2100 
2101 
2102 
2103 
2104 
2105 
2106 
2107 
2108 
2109 
2110 
2111 
2112 


ADDR 


EAED 
EAEF 
EAF1 
EAF4 
EAF6 
EAF9 
EAFB 
EAFD 


EBOO 
EBOS3 
EBOS 
EBO7 
EBO? 
EBOA 
EBOC 


EBOE 


EBOF 
EB1O 


EB11 
EB1L4 
EB17 


EB19 
EBIB 


EBiD 
EBIF 


EB21 
EB23 


EB25 
EB27 


4G 


Be BS B4 


1B EC 


03 D3 


AC ED 


17 O3 


Si9o ¢ 


CHKTIM: 
NTBRKL: 


GOBACK: 


TOUT: 


a a ee ee ee ee 


ee ee ee ee ee ee et 


ISRSIR: 


RETRN: 


SERIAL BUS INPUT/OUTPUT CONTROLLER } 


LDA 
STA 
JSR 
LDA 
STA 
LDA 
BNE 
JMP 


LBA 
BEG 
LDA 
BEG 
RTS 
LDA 
STA 


RTS 


TYA 
PHA 


LDA 
STA 


jo ARHHHHHH 


NTOVRN: 


BMI 


LDY 
STY 


AND 
BNE 


LDY 
STY 


LDA 
BEG 


#SUCCES 
STATUS 
RECVEN 
#NCOMHI 
PBCTL 
BRKKEY- 
NTBRAIL 
BROKE 


TIMFLG 
TOUT 

RECVDN 
CHATIM 


#TIMOUT 
STATUS 


SASTAT 
SKRES 


THIS MAY NOT BE THE PLACE TO DO IT 


NTFRAM 


#FRMERR 


STATUS 


#320 
NTOVRN 


#OVRRUN 


STATUS 


BUFRFL 
NOTYET 


PAGE 


i SET GOOB STATUS FOR DEFAULT CASE. 
iDO RECEIVE ENABLE 

i COMMAND FRAME HI COMMAND 

i STORE IN PIA 

; JUMP IF BREAK KEY PRESSED 


7 NO, 
i IF TIMEOUT, GO SET ERROR STATUS 


i DONE * 


: YES, 
iSET TIMEQUT STATUS 


; RETURN 


SERIAL INPUT READY INTERRUPT SERVICE ROUTINE 


i SAVE Y REG ON STACK 


iRESET STATUS REGISTER 


HKPHHARHH 


i BRANCH IF NO FRAMING ERROR 


i SET FRAME ERRORR STATUS 


i BRANCH IF NO OVERRUN ERROR 


i SET OVERRUN ERROR STATUS 


i BRANCH IF BUFFER WAS NOT YET FILLED 


48 


ERR LINE 


2113 
2114 
2115 
2116 
2117 
2118 
2119 
2120 
2121 
2122 
2123 
2124 
2125 
2126 
2127 
2128 
2129 
2130 
2131 
2132 
2133 
2134 
2135 
21346 
2137 
2138 
2139 
2140 
2141 
2142 
2143 
2144 
2145 
2146 
2147 
2148 
2149 
2150 


2151 . 


2152 
2153 
2154 
2155 
2156 
2157 
2158 
2159? 
2140 
2141 
2162 
2163 
2164 


2145" 


2466 


ADDR 


EG29 
EB2C 
EB2E 


EB30 
EBS2 


EBS4 
EB36 


EB38 
EBS? 
EBSA 
EBSB 


EB3C 
EBSF 
EB41 


EB43 
EB44 
EB46 
EB48 


EB4A 
EB4C 
EB4E 


EBSO 
EBS2 
EBS4 
EBS6 
EBSS 


EBSA 
EBSC 


EBSE. 
EBSO 


EBé2 
EB6G4 
EBS64 


EBéS 


Be 


Ba B84 


D2 
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SRETRN: 


SUSUAL : 


i 


i 


NOTYET: 


NTWRP 1: 


a ae eT 


LDA 
CMP 
BEG 


LDBY 
STY 


SERIN 
CHKASUM 
SRETRN 


#CHKERR 
STATUS 


#$FF 
RECVDN 


SERIN 
#0 


i THIS INPUT BYTE IS THE CHECKSUM 


i BRANCH IF CHECKSUMS MATCH 


i SET CHECKSUM ERROR STATUS 


i SET RECEIVE DONE FLAG 


;RESTORE Y REG 
iRETURN FROM INTERRUPT 


(BUFRLO?, Y STORE INPUT REGISTER INTO BUFFER 


CHKSUM 
#0 
CHKSUM 


BUFRLO 
NTWRP 1 
BUFRHI 


BUFRLO 
BFENLO 


‘BUFRHI 


BFENHI 
SUSUAL 


NOCKSM 
GOON 


#0 
NOCKSM 


SRETRN 


#$FF 


BUFRFL 


SUSUAL. 


i+ADD IT TO CHECKSUM 


i INCREMENT BUFFER POINTER 


i BRANCH IF NEW BUFFER ADDRESS IS IN BUFFER L 


i BRANCH IF A CHECKSUM WILL FOLLOW DATA 


i CLEAR NO CHECKSUM FLAG 


iGO RETURN AND SET RECEIVE DONE FLAG 


iSET BUFFER FULL FLAG 


iGO RETURN 


ERR LINE 


2167 
2168 
2149 
2170 
2171 
2172 
2173 
2174 
2175 
2176 
2177 
2178 
2179 
2180 
2181 
2182 
2183 
2184 
2185 
2186 
2187 
2188 
2189 
2190 
2191 
2192 
2193 
2194 
2199 
2196 
2197 
2198 
2199 
2200 
2201 
2202 
2203 
2204 
2205 
2206 
2207 
2208 
2209 
2210 
2211 
2212 
2213 
2214 
2215 
2216 
2217 
2218 
2219 
2220 


ADDR Bi B2 BS B4 


EB6A 
EB&B 
EBSE 
EB70O 
EB73 


EB75 
EB78 
EB7A 
EB7D 


EB7F 


EBS8O 
EB83 


EBS5 
EBS7 
EBBA 
EBSC 


EBSF 
EB?2 
EBO4 
EB97 
EBS? 
EB9B 
EB?D 


EBAO 
EBA2 


EBAS 


03 


03 


03 


03 


03 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER >) PAGE 90 


ASENT: 


i WRITE 


i 


SRTIRO: 


TIMIT: 


i CASSETTE HANDLING CODE 
Cc 


LOAD BUFFER POINTER SUBROUTINE 


LOAD BUFFER POINTER WITH DCB BUFFER INFORMATION 


CLC 

LDA DBUFLO 

STA BUFRLO 

ADC DBYTLO 

STA BFENLO i ALSO SET BUFFER END + 1 ADDRESS 
LDA DBUFHI 

STA BUFRHI 

ADC DBYTHI 

STA BFENHI 

RTS i RETURN 


LDA DSTATS 


BPL. CASRED i; BRANCH IF INPUT FROM CASSETTE 
A RECORD 

LDA #B600L0 ;SET BAUD RATE TO 600 

STA AUDF3 

LDA #B600HI 

STA AUDF 4 

JSR SENDEN ; TURN ON POKEY MARK TONE 

LDY #WSIRG ;LOAD SHORT WRITE INTER RECORD GAP TIME 
LDA DAUX2 

BMI SRTIRO ; BRANCH IF SHORT GAP IS DESIRED 

LDY #WIRGLO ;SET WRITE IRG TIME 

LDX #WIRGHI 

JSR SETVBX 

LDA #MOTRGO 

STA PACTL ; TURN ON MOTOR 

LDA TIMFLG ;LOOP UNTIL DONE 


ERR LINE 


2221 


2222 
2223 
2224 
2225 
2226 
2227 
2228 
2229 
2230 
2231 
2232 
2233 
2234 
2235 
2236 
2237 
2238 
2239 
2240 
224i 
2242 
2243 
2244 
2245 
2246 
2247 
2248 
2249 
2250 
2251 
2292 
2253 
2254 
2255 
2256 
2257 
2258 
2259 
2260 
2261 
2262 
2243 
2264 
2265 
2266 
2267 
2268 
2269 
2270 
2271 
2272 
2273 
2274 


ADDR 
EBAS 
EBAA 
EBAD 


EBRBO 


EBEC 
OOEB 
OOEC 
EBEE 


Bi 
BO 
20 
20 


4C 


AF 


8D 


B2 


FB 


5A 


6B 


DF 


00 


17 


B3 B4 


EB 
EA 


EB 


03 


03 


ED 


D3 


03 


EB 


EC 
ED 


ED 
EA 


03 


D3 


EA 


03 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER >) PAGE ro B | 
BNE TIMIT 
i 
JSR LDPNTR iLOAD BUFFER POINTER WITH DCB INFORMATION 
i 
JSR SEND i SEND A BUFFER 
JMP CRETRN iGO RETURN 
i 
i RECEIVE A RECORD 
CASRED: LDA #$FF 
STA CASFLG iSET SET CASSETTE FLAG 
LDY #RSIRG iLOAD SHORT READ INTER RECORD GAP TIME 
LDA DAUX2 
BMI SRTIRI iBRANCH IF SHORT GAP IS DESIRED 
LDY #RIRGLO i;SET TIME OUT FOR READ IRGC 
SRTIRi: LDX #RIRGHI 
JSR SETVEX 
LDA #MOTRGO 
STA PACTL i TURN ON MOTOR 
TIMITi: LDA TIMFLG iLOOP UNTIL DONE 
BNE TIMIT1 
JSR LDPNTR iLOAD BUFFER POINTER WITH DCB INFORMATION 
JSR STTMOT iSET DEVICE TIME OUT IN Y. X 
JSR SETVBX 
JSR BEGIN iSET INITIAL BAUD RATE 
JSR RECEIV iGO RECEIVE A BLOCK 
CRETRN: LDA DAUXK2 
BMI SRTIR2 i BRANCH IF DOING SHORT INTER RECORD GAPS 
i DON’T TURN OFF CASSETTE MOTOR 
LDA #MOTRST 
STA PACTL i TURN OFF MOTOR 
SRTIR2: JUMP RETURN iGO RETURN 
JTIMER: LDA #300 
JTADRH = JTIMER/256 iHI BYTE OF JUMP TIMER ROUTINE ADDR 
JTADRL = (-256)} #UTADRH+JT IMER 


STA 


TIMFLG 


i SET TIME OUT FLAG 


ERR LINE 


2275 
2276 
2277 
2278 
2279 
2280 
2281 
2282 
2283 
2284 
2285 
2286 
2287 
2288 
2289 
2290 
2291 
2292 
2293 
2294 
2295 
2296 
2297 
2298 
2299 
2300 
2301 
2302 
2303 
2304 
2305 
2306 
2307 
2308 
2309 
2310 
23il 
2312 
2313 
2314 
2315 
2316 
2317 
2318 
2319 
2320 
2321 
2322 
2323 
2324 
2325 
2326 
2327 
2328 


ADDR 


EBF1 


EBF2 
EBF4 
EBF7 


EBF9 
EBFC 
EBFE 


ECOO 


ECO2 
ECO4 
ECO7 
ECO? 


ECOC 
ECOF 


ECi2 
ECc14 
EC16 


ECi8 


ECiB 
ECiD 
EC20 
EC22 


EC25 


EC28 


EC2B 


Bi Be BS B4 


60 


O02 


03 


De 


Be 


02 
D2 


EC 


02 


02 
D2 


D2 


SiO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) 


i 
a 
i 
i 
i 
ii 
i 
i 


SENDEN: 


i 
NOTCAS: 


ECVEN: 


RTS 


LDA 
AND 
ORA 


LDY 
CPY 
BNE 


ORA 


LDY 
STY 
LDY 
STY 


STA 
STA 


LDA 
AND 


ORA © 


JMP 


LDA 
AND 
ORA 
STA 
STA 


STA 


LDA 


SEND ENABLE SUBROUTINE 


#$O7 
SSKCTL 
#$26 


DDEVIC 
#CASET 
NOTCAS 


#¢08 


#LOTONE 
AUDFe2 
#HI TONE 
AUDF 1 


SSKCTL 
SKCTL 


#$C7 


POKMSK 
#$10 


CONTIN 


RECEIVE ENABLE SUBROUTINE 


#407 
SSKCTL 
#$10 
SSKC TL 
SKCTL 


SKRES 


#507 


PAGE 32 


iMASK OFF PREVIOUS SERIAL BUS CONTROL BITS 


i SET TRANSMIT MODE 


i BRANCH IF NOT CASSETTE 
iSET THE FSK OUTPUT BIT 


i SET FSK TONE FREQUENCIES 


iSTORE NEW VALUE TO SYSTEM MASK 
iSTORE TO ACTUAL REGISTER 


i MASK OFF PREVIOUS SERIAL BUS INTERRUPT BITS 


iENABLE OUTPUT DATA NEEDED INTERRUPT 


iGO CONTINUE IN RECEIVE ENABLE SUBROUTINE 


iMASK OFF PREVIOUS SERIAL BUS CONTROL BITS 
iSET RECEIVE MODE ASYNCH. 

+STORE NEW VALUE TO SYSTEM MASK 

iSTORE TO ACTUAL REGISTER 

iRESET SERIAL PORT/KEYBOARD STATUS REGISTER 


iMASK OFF PREVIOUS SERIAL BUS INTERRUPT BITS 


ERR LINE 


2329 
2330 
2331 
2332 
2333 
2334 
2335 
2336 
2337 
2398 
2339 
2340 
2341 
2342 
2343 
2344 
2345 
2346 
2347 
2348 
2349 
2350 
2351 
2352 
2353 
2354 
2355 
2356 
2357 
2358 
2359 
2360 
2361 
2362 
2363 
2364 
2365 
2366 
2367 
2368 
2369 
2370 
2371 
2372 
2373 
2374 
2375 
2376 
2377 
2378 
2379 
2380 
2381 
2382 


BS B4 


B2 


D2 


D2 


D2 
03 


D2 
B2 


De 


De 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) PAGE 
AND POKMSK 
ORA #526 i ENABLE RECEIVE INTERRUPT 

CONTIN: STA POKMSK i STORE NEW VALUE TO SYSTEM MASK 
STA TRGEN ;STORE TO ACTUAL REGISTER 
LDA #$28 iCLOCK CH. 3 WITH 1.79 MHZ 
STA AUDCTL iCLOCK CH. 4 WITH CH. 3&3 
LDX #6 i SET PURE TONES, NO VOLUME 
LDA #$AS 
LDY SOUNDR i TEST QUIET 1/0 FLAG 
BNE NOISE1 iNE IS NORMAL (NOISY?) 
LDA #$A0 

NOISE1: STA AUDCI: X 
DEX 
DEX 
BPL NOISE1 
LDA #$A0 
STA AUBCS i TURN OFF SOUND ON CHANNEL 3 
LDY DDEVIC 
CPY #CASET 
BEG CAS31 i BRANCH IF CASSETTE IS DESIRED 
STA AUDC i i; OTHERWISE TURN OFF CHANNELS 1 AND 2 
STA 4UDC] 

AS3i: RTS i RETURN 


Cc 
i 
i 
SENDDS: 


RECVDS: 


ZERIT: 


DISABLE SEND AND DISABLE RECEIVE SUBROUTINES 


#$C7 iMASK OFF SERIAL BUS INTERRUPTS 
POKMSK 

POKMSK iSTORE NEW VALUE TO SYSTEM MASK 
IRGEN iSTORE TO ACTUAL REGISTER 

#4 

#0 

AUDC 1. X 

ZERIT i TURN OFF AUDIO VOLUME 


oa 


ERR LINE ADDR Bi B82 BS B4 SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER > PAGE 
{ 

2383 EC74 4&6 RTS i; RETURN 
2384 ; 
2385 i 
2386 j 
2387 F 
2388 i 
2389 i 
2390 j 
2391 i 
2992 F 
2393 i 
2394 i SET DDEVICE TIME OUT VALUES IN Y, X SUBROUTINE 

2995 i 

2396 EC75 AD 04 03 STTMOT: LDA DTIMLO iGET DEVICE TIME OUT IN 1 SECOND INCR 

2397 EC78 6A ROR A ;PUT 6 HI BITS IN X, LO 2 BITS IN Y 

2398 EC79 GA ROR A 

2399 EC7A 4&8 TAY i TEMP SAVE 

2400 EC7B 29 3F AND #$3F iMASK OFF 2 HI BITS 

2401 EC7D AA TAX i THIS IS HI BYTE OF TIME OUT 

2402 F 

2403 EC7E 98 TYA ; RESTORE 

2404 EC7F 6A ROR A : 

2405 EC80 29 CO AND #$CO iMASK OFF ALL BUT 2 HI BITS 

2406 EC82 As TAY i THIS IS LO BYTE OF TIME OUT 

2407 i 

2408 ECS3 40 RTS 

2409 

2410 

24il 

2412 

2413 

2414 

2415 

2416 

2417 

2418 

2419 EC84 OF EB NTTBL: . WORD ISRSIR i SERIAL INPUT READY 

2420 EC86 9906 EA . WORD ISRODN i; OUTPUT DATA NEEDED 

2421 EC88 CF EA . WORD ISRTD i TRANSMISSION DONE 

2422 ; 

2423 OOEB | SIRHI 

2424 OOOF SIRLO 

2425 OOEA ODNHI 

2426 0090 ODNLO 

2427 OOEA TDHI 

2428 OOCF TDLO 

24297 i 

2430 ; 

2431 ; 

2432 : 

2433 i SEND A DATA FRAME TO AN INTELLIGENT PERIPHERAL SUBROUTINE 


Pq Teme ee 


ISRSIR/256 iSERIAL INPUT READY ISR ADDRESS 
(-254)#SITRHI+ISRSIR 

ISROGN/2564 i;OUTPUT DATA NEEDED ISR ADDRESS 
(-256) #OBNHI+ISRODN 

ISRTD/256 i TRANSMISSION DONE ISR ADDRESS 
(-254)#TBHI+ISRTD 


houd tan 


2434 
2435 
2436 ECBA A2 O01 | SENDIN: LDX #$01 


ERR LINE ADDR Bi Be B3 B4 SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) PAGE 


2437 EC8C AC FF  DELAYG: LDY #$FF 

2438 ECS8E 89 DELAY1: DEY 

2439 EC8SF DO FD BNE DELAY1 

2440 EC91L CA DEX 

2441 EC92 BO FB BNE DELAYS 

2442 F 

2443 EC94 26 4B EA JSR SENG iGO SEND THE DATA FRAME 
2444 F 

2445 EC97 AG G2 . LDY #CTIMLO iSET ACK TIME OUT 

2445 EC99 A2 06 LDX #CTIMHI 

2447 EC9B 206 BS EB ; WAITER: JSR SETVBX 

2448 i 

2449 ECSE 20 1A EA JSR WAIT iWAIT FOR ACK 

2450 i 

2451 ECAL 989 TYA i IF Y=0, A TIME OUT OR NACK OCCURED 
2452 i 

2453 ECA2 4&0 RTS ; RETURN 

2454 i 

2455 i 

2456 i 

2457 i 

2458 i 

2459 i 

24540 i 

2461 ; 

2462 i 

2443 i 

2464 i 

24465 ; COMPUTE VALUE FOR POKEY FREQ REGS FOR THE BAUD RATE AS 
2446 i MEASURED BY AN INTERVAL OF THE ‘VCOUNT’ TIMER. 
2467 i 

2468 ECAS 8D iC 03 COMPUT: STA TIMER] 

2469 ECAS& 8C 11 03 STY TIMER2+1 i SAVE FINAL TIMER VALUE 
2470 ECAQ 260 04 EB JSR ADJUST i ADJUST VCOUNT VALUE 
2471 ECAC 8B iC 03 STA TIMER] i SAVE ADJUSTED VALUE 
2472 ECAF AB OC O02 LDA TIMER 

2473 ECB2 20 04 ED JSR ADJUST i ADJUST 

2474 ECBS 8b 0c 63 STA TIMER i SAVE ADJUSTED TIMERI VALUE 
2475 ECBS AB 10 03 LDA TIMER2 

2476 ECBB 39 SEC 

2477 ECBC ED OC O3 SBC TIMER1 

2478 ECBF 8D 12 03 STA TEMP 1 iFIND VCOUNT DIFFERENCE 
2479 ECC2 AD 11 03 LDA TIMER2+1 

2480 ECCS 38 SEC 

2481 ECCS ED OD 03 SBC TIMERI+1 

2482 ECC? Ags TAY iFIND VBLANK COUNT DIFFERENCE 
2483 IF PALFLG 

2484 LDA #-$9C 

2485 HITIMR: CLC 

24B6 ADC #$9C 

2487 . ENDIF 

2488 IF PALFLG-1 

2489 ECCA AG? 7B LDA #-$83 


2490 ECCC 18 HITIMR: CLC 


ERR LINE 


EDO4 
EDOS 
EDOS 
EDO? 
EDOB 
EBOC 


EDOD 


EDOF 


6F 


£0 


Be BS B4 


83 


FA 


12 


7¢ 


7 


07 


03 


03 


ED 


03 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER } PAGE 56 
ADC #383 i ACCUMULATE MULTIPLICATION 
. ENDIF 
DEY 
BPL HITIMR i DONE? 
CLC 
ADC TEMP i i TOTAL VCOUNT DIFFERENCE 
FINDX: TAY i SAVE ACCUM 
LSR & 
LSR A 
LSR A 
ASL 4é 
SEC 
SBC #22 i ADJUST TABLE INDEX 
TAX iDIVIDE INTERVAL BY 4 TO GET TABLE INDEX 
TYA i RESTORE ACCUM 
AND #7 
TAY PULL OFF 3 LO BITS OF INTERVAL 
LDA #-11 
DOINTP: CLC 
ADC #il i ACCUMULATE INTERPOLATION CONSTANT 
DEY 
BPL DOINTP i INTERPOLATION CONSTANT COMPUTATION DONE? 
ENINTP: LDY #0 
STY ADDCOR iCLEAR ADDITION CORRECTION FLAG 
SEC 
SBC #7 i+ ADJUST INTERPOLATION CONSTANT 
BPL PLUS 
BEC ADDCOR 
PLUS: CLC 
ABC POKTAB, X *#ADD CONSTANT TO LO BYTE TABLE VALUE 
TAY iLO BYTE POKEY FREG@ VALUE 
LDA ADDCOR 
ADC POKTAB+1,X iADD CARRY TO HI BYTE TABLE VALUE 
i HI BYTE POKEY FREG@ VALUE 
RTS 
i ROUTINE TO ADJUST VCOUNT VALUE 
ADJUST: CMP #$7C 
BMI ADJ1 iLARGER THAN ’7C’ ? 
SEC i YES, 
SBC €$7C 
RTS 
ADJ1: CLC 
«AF PALFLG 
ABC #$20 
ENDIF 
_ IF PALFLG-1 
ADC #47 
ENDIF 


ERR LINE 


2945 
2546 
2547 
2548 
2549 
2550 
2551 
2552 
29993 
2554 
2555 
2556 
2557 
auld 
2399 
2540 
2561 
2542 
2563 
2564 
2565 
2566 
2967 
2568 
2549 
2570 
2571 
2572 
2573 
2574 
2575 
2576 
23577 
2578 
2579 
2580 
2581 
2582 
2583 
2584 
2585 
2586 
2587 
2588 
2589 
2590 
2591 
2992 
2593 
2594 
2595 
2596 
2597 
2598 


ADDR Bi Be BS BA 


EDLO 
EDI2 
ED14 


ED17 


EDi8s 
EDiB 
ED1ID 


EDIF 
ED22 
ED24 
ED26 
ED29 
ED2Cc 
ED2E 
EDSI1 


ED34 
ED36 
EDS? 
ED3B 
EDSD 


ED3F 
ED42 
ED44 
ED4S 


ED4s8 
ED4B 
ED4D 
EDSO 
EDS2 
EDSS 
EDS6é 


EDS8 
EDSB 
EDSD 


ED 


03 


03 


D4 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ?} 


os a 


EGIN: 


NTBRK2: 


COUNT: 


TOUT1: 


OKTIMR: 


INITIAL BAUD RATE MEASUREMENT -- USED TO SET THE 
BAUD RATE AT THE START OF A RECORD. 


LDA 
BNE 
MP 


SEI 


LDA 
BNE 
BEG 


LDA 
AND 
BNE 
STA 
LDX 
LDBY 
STX 
STY 


LDX 
STX 
LDY 
LDA 
BEG 


LDA 
BNE 
CLI 
JMP 


LDA 
AND 
CMP 
BEQ 


‘STA 


DEY 
BNE 


DEC 
BMI 
LDA 


PAGE 


It IS ASSUMED THAT THE FIRST TWO BYTES OF EVERY 


RECORD ARE ‘AA’ HEX. 


BRKKEY 
NTBRK2 
BROKE 


TIMFLG 
OKTIMi 
TOUTi 


SKSTAT 
#410 
BEGIN 
SAVIO 
VCOUNT 
RTCLOK+2 
TIMERI 
TIMERI+1 


#1 
TEMPS 
#10 
BRKKEY 
BROKE 


TIMFLG 
OKTIMR 


TOUT 


SKSTAT 
#$10 
SAVIO 
COUNT 
SAVIO 


COUNT 
TEMPS 


GOREAD 
VCOUNT 


i JUMP IF BREAK KEY PRESSED 


i BRANCH IF NOT TIMED OUT 
iBRANCH IF TIME OUT 


iREAD SERIAL PORT 
iSTART BIT? | 

i SAVE SER. DATA IN 

;#READ VERTICAL LINE COUNTER 
iREAD LO BYTE OF VBLANK CLOCK 
iSAVE INITIAL TIMER VALUE 
iSET MODE FLAG 

iSET BIT COUNTER FOR 10 BITS 


i BRANCH IF BREAK KEY PRESSED 


i BRANCH IF NOT TIMED OUT 
iBRANCH IF TIME OUT 
iREAD SERIAL PORT 

i DATA IN CHANGED YET? 

i YES, SAVE SER. DATA IN 
iDECR. BIT COUNTER 

i DONE? 


7 YES, 
i DONE WITH BOTH MODES? 


37 


ERR LINE ADDR Bi Be B3 B4 SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) PAGE 


2599 ED60 A4 14 LDY RTCLOK+2 ;READ TIMER LO & HI BYTES 
2600 ED62 26 AB EC JSR COMPUT ;NO, COMPUTE BAUD RATE 

2601 ED65 8c EE 02 STY CBAUDL 

2602 ED468 8D EF 02 STA CBAUDH ;SET BAUD RATE INTO RAM CELLS 
2603 ED4B AQ OF LDY #9 ;SET BIT COUNTER FOR 9 BITS 
2604 ED46D po cc BNE COUNT 

2605 ; 

2606 ED6F AD EE 02 GOREAD: LDA CBAUDL 

2607 ED72 8D 04 D2 STA AUDF3 

2608 ED75 AD EF 02 LDA CBAUDH 

2609 ED78 8D 06 D2 STA AUDF4 ;SET POKEY FREG@ REGS FOR BAUD RATE 
2610 ED7B A? 00 LDA #0 

2611 ED7D 8D OF D2 STA SKSTAT 

2612 ED80 AD 32 02 LDA SSKCTL 

2613 EDS3 8D OF D2 STA SKSTAT ; INIT. POKEY SERIAL PORT 

2614 EDB46 A? 55 LDA #$55 

2615 EDSB8 91 32 STA (BUFRLO),Y iSTORE ‘$55’ AS FIRST RCV. BUFFER 
2616 EDBA Cs INY 

2617 EDSB 91 32 STA (BUFRLO), Y 

2618 EDSD A? AA LDA #SAA 

2619 EDSF 85 31 STA CHKSUM ; STORE CHECKSUM FOR 2 BYTES OF ‘SAA‘ 
2420 ED91 18 CLC 

2621 ED92 A5 32 LDA BUFRLO 

2622 ED94 469 02 ADC #2 

2423 ED96 85 32 STA BUFRLO 

2624 ED98 AS 33 LDA BUFRHI 

2625 ED9A 69 00 ADC #0 

2626 ED9C 85 33 STA BUFRHI ; INCR. BUFFER POINTER BY 1 
2627 EDIE 58 CLI 

2628 ED9F 40 RTS 

2629 ; 

2430 i 

2431 ; 

2632 EDAO 20 SF EC BROKE: JSR SENDDS ; BREAK KEY WAS PRESSED, SO PREPARE 
2633 EDAS A? 3C LDA #MOTRST ;TO RETURN 

2634 EDAS 8D 02 D3 STA PACTL ; TURN OFF MOTOR 

2635 EDAS sp 03 D3 STA PBCTL ;RAISE NOT COMMAND LINE 

2636 F 

2637 EDAB A? 8G LDA #BRKABT 

26398 EDAD 985 30 STA STATUS ; STORE BREAK ABORT STATUS CODE 
2639 i ; 

2640 EDAF AE 18 03 LDX STACKP i 

2641 EDB2 94 | TXS ;RESTORE STACK POINTER 

2642 F 

2643 EDBS C4 iil DEC BRKKEY ;SET BREAK KEY FLAG TO NONZERO 
2644 EDBS 58 CLI ; ALLOW IRQ‘S 

2649 i 

2646 EDB& 4C OD EA JMP RETURN iGO RETURN 

2647 i 

2648 ; 

2649 i 

2650 i 

2651 F 

2452 EDB9 A? EC SETVBX: LDA #UTADREL ; STORE TIME OUT ROUTINE ADDRESS 


ERR LINE 


2653 
2654 
2655 
2656 
2657 
2658 
2659 
2660 
2641 
24662 
2663 
2664 
2665 
2666 
2667 
2668 
2669 
2670 
2671 
2472 
2473 
2674 
2675 
2676 
2677 
2478 
2679 
2480 
2681 
2682 
2683 
24684 
2485 
2486 
26B7 
2488 
2689 
2690 
2491 
2692 
2693 
2494 
2695 
2696 
2697 
2698 
2699 
2700 
2701 
2702 
2703 
2704 
2709 
2706 


ADDR 


EDBB 
EDBE 
EDCO 


EDC3 


EDCS 
EDCS6 
EDC? 
EDCB 
EDCE 


EDCF 


EDDO 
EDD2 
EDD4 
EDDG 
EDDS 
EDDA 
EDDC 
EDDE 


BS B4 


02 


02 


E4 


03 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ) PAGE 39 
STA CDTMA1 
LDA #JTADRH 
STA CDTIMA1I+1 
LDA #71 iSET FOR TIMER 1 
SEI i THE SETVBL ROUTINE NEEDS THIS TO CUT SHORT 
JSR SETVBYV i ANY VBLANKS THAT OCCUR 
LDA #1 “+ SET FOR TIMER 1 
STA TIMFLG iSET FLAG TO NOT TIMED OUT 
CLI 
RTS 

‘VCOUNT’ INTERVAL TIMER MEASUREMENT -- TO —- POKEY FREG@ REG VALUE 


“a ~ a eT Te Te TT Te Ci i Ta i eh ht i af eel eid 


OKTAB: 


CONVERSION TABLE 


THE VALUES STORED IN THE TABLE ARE ‘AUDF+7’. 


THE FOLLOWING FORMULAS WERE USED TO DETERMINE THE TABLE VALUES: 


~F OUT= F IN/(2#(AUDF+M)) . WHERE F IN=1. 78979 MHZ. & M=7 


FROM THIS WAS DERIVED THE FORMULA USED TO COMPUTE THE 
TABLE VALUES BASED ON A MEASUREMENT OF THE PERIOD BY 


AN INTERVAL OF THE 


. WORD 
. WORD 
. WORD 
. WORD 
. WORD 
. WORD 
. WORD 
. WORD 
. WORD 
. WORD 
. WORD 
. WORD 


“VCOUNT’ TIMER. 


AUDF+7=(11.365167)#T OUT, WHERE T OUT=# OF COUNTS 
(127 USEC. RESOLUTION) OF ‘VCOUNT’ FOR 1 
CHARACTER TIME (10 BIT TIMES). 


AUDF +7 


na enete cate cette meee soem, 


BAUD RATE VCOUNT INTERVAL 
i 1407 96 
+1231 64 
i 1094 72 
i985 80 
i895 88 
i820 96 
i737 104 
i703 112 
i656 120 
i415 128 
i979 136 


ERR LINE ADDR Bi Be BS B4 STO ¢ SERIAL BUS INPUT/OUTPUT CONTROLLER } PAGE 40 


2707 EDEO CO 06 . WORD $6C0 +518 152 
2708 EDE2 iA 07 . WORD $714 i492 160 
2709 EDE4 75 07 . WORD $775 +4469 168 
2710 EDES BO 67 . WORD $7D0 + 447 176 
2711 i . WORD $828 i428 184 
2712 ; . WORD $886 . +410 192 - 
2713 i . WORD $8E1 1 394 200 
2714 i . WORD $93C i379 208 
2715 i . WORD $997 i365 216 
2716 i . WORD $9F2 +352 224 
2717 i . WORD $A4D i339 : 232 
2718 i . WORD SAAB i328 240 
2719 i .WORD $803 i318 248 
2720 i 

2721 i 

2722 i 

2723 i 

2724 j HHA RHA R AHHH AHR ARAEHRAHRE HHA EHRERES 
2725 EDES CRNTPS = 

2726 #=G14 


2727 0014 C2 SIOSPR: . BYTE DSKORG-CRNTPS i “GSIOL IS TOO LONG 


ERR LINE 


2728 
2729 
2730 
2731 
2732 
2733 
2734 
2735 
2736 
2737 
2738 
2739 
2740 
2741 
2742 
2743 
2744 
2745 
2746 
2747 
2748 
2749 
2750 
27951 
2752 
2753 
2754 
2795 
2756 
2757 
2758 
2759 
2740 
2761 
2762 
2763 
2764 
2765 
2766 
2767 
2768 
2769 
2770 
2771 
2772 
2773 
2774 
2775 
2776 
2777 
2778 
2779 
2780 
2781 


ADDR Bi Be BS B4 


0002 
OOEA 


0031 
0050 


0053 
0021 
0000 
0040 
0080 


E450 
E453 


4c EA ED 
4C FO ED 


SIO ( SERIAL BUS INPUT/OUTPUT CONTROLLER ?) PAGE él 


i 
i 
i 
i 
i 
i 


STATVH 
STATVL 


er ee Te Te Pe Te 


Se ee ee TC Te oy 


_ TITLE “‘BISK *###% DISKP. SRC ###e2 B/G/79 HHHRH 4:00:00 P.M. “ 


DYVSTAT/256 
(-2546)3#STATVH+DVSTAT i STATUS POINTER 


CONSTANT EQUATES 


= $3t iSERIAL BUS DISK 1. D. 

= $50 ;DISK PUT SECTOR DCB COMMAND 

= $52 iDISK GET SECTOR DCB COMMAND 

= $57 i DISK PUT SECTOR WITH READ CHECK DCB COMMAND 
= $53 i DISK STATUS DCB COMMAND 

= $21 i DISK FORMAT DCB COMMAND !!1!!! ###%% 
= 0 *+SIO COMMAND FOR “NO DATA" OPERATION 
= $40 i#SIQ COMMAND FOR "DATA FROM DEVICE" 
= $80 *SIO COMMAND FOR "DATA TO DEVICE" 
VECTORS 

#=$E 450 

JMP DINIT iDISK INIT. VECTOR 

JMP DSKIF iDISK INTERFACE ENTRY POINT 
CONSTANTS 

#=DSKORG 


b MHHHAKAAAKHHRRAKHAHRHRHHHAARHEHHKARHRHHAHHAHHHHKHHEHHRHEHHKHHRHHREHHHHHRARHRERE 


i 


DISK INTERFACE ROUTINE STARTS HERE 


fj PHHHAAAAAHAHAAKAARAHAHHAKAAPFAHAAAKSRHRAHHHRRHHHAHHHHHAKHAAHAHHHAAHKRARRHEHS 


ERR LINE 


2782 
2783 
2784 
2785 
2786 
2787 
2788 
2789 
2790 
2791 
2792 
2793 
2794 
2799 
2796 
2797 
2798 
2799 
2800 
2801 
2802 
2803 
2804 
2805 
2806 
2807 
2808 
2809 
2810 
2811 
2812 
2813 
2814 
2815 
2816 
2817 
2818 
2819 
2820 
2621 
2822 
2823 
2824 
2825 
2826 
2827 
2828 
28297 
2830 
2831 
2832 
2833 
2834 
2835 


ADDR 


EDEA 
EDEC 
EDEF 


B1 


a? 


40 


Be 


AG 


BS B4 


O03 


03 


03 


EE 


02 
03 


EE 


DISK 


a Ta Ty 


DINIT: 


sd 


DSKIF: 


PUTDTO: 


CKSTC: 


PUTCNT: 


GOODST: 


PUTBC: 


FMTD: 


222% BDISKP. GRC #28442 B/G/79 zteee 


4:00: 00 PAGE 62 


DISK INTERFACE INITIALIZATION ROUTINE 


LDA 
STA 
RTS 


#140 
BDSKTIM 


/ 


iSET INITIAL DISK TIMEOUT TO 160 SEC 


DISK INTERFACE ENTRY POINT 


LDA 
STA 
LDA 
LDX 
CPX 
BEG 
LDA 
STA 
LDX 
LDY 
LDA 
CMP 
BNE 
L.DX 
CMP 
BNE 
LDA 
STA 
LDA 
STA 
LDY 
STX 
STY 
LDA 
STA 
JSR 
BPL 
RTS 
LDA 
CMP 
BNE 
JSR 
LDBY 
LDA 
STA 
LDA 
CMP 
BNE 
JSR 
LDY 


#DISKID 
DDEVIC 


DTIMLO 
#GETDAT 
#$80 
DCOMND 
#WRITE 
CKASTC 
#PUTBAT 
#STATC 


GOODST 


DCOMND 


(BUFADR?. ¥ 


DSKTIM 
DCOMND 
#FOMAT 
ENDDIF 
PUTABR 
#$FE 


iSET SERIAL BUS I.D IN DCB 


i IS COMMAND 4&4 FORMAT COMMAND? 


iNO, SET TIMEOUT TO 7 SECS. 

iPUT DISK TIMEOUT IN DCB 

iSET “GET DATA" COMMAND FOR SIO 
iSET BYTE COUNT TO 128 

iREAD COMMAND IN DCB 

i IS COMMAND A "PUT SECTOR" COMMAND? 


iYES. SET "PUT DATA" COMMAND FOR SIO 
i 1S COMMAND A STATUS COMMAND? 


iSET BUFFER ADDR TO GLOBAL STATUS BUFFER 
i YES. SET BYTE COUNT TO 4 
iPUT STATUS COMMAND FOR SIO IN DCB 


iPUT BYTE COUNT IN DCB 
iCALL SERIAL 170. 

iNO ERROR 

*#NO, GO BACK 

iREAD THE COMMAND 

iWAS IT A STATUS COMMAND? 


iPUT BUFFER ADDR IN TEMP REG. 


iREAD DISK TIMEOUT VALUE BYTE OF STATUS 
iPUT IT IN DISK TIMEOUT REG. 


iWAS COMMAND A FORMAT COMMAND? 


iYES. PUT BUFFER ADDR INTO TEMP REG 
i SET BUFFER POINTER 


ERR LINE ADDR Bi B2 BS B4 DISK ##### DISKP. SRC s#28## 3/9/79 BHtHH 4:00:00 PAGE 


28364 EE4F CB , TWICE: INY 

2837 EESO cs INY i INCR BUFFER POINTER BY 2 
2838 EE51 Bi 15 RDBAB: LDA (BUFADR}, Y ijREAD LO BYTE BAD SECTOR DATA 
2839 EESS Cc? FF CMP #SFF 

2840 EESS po FS BNE TWICE iIS IT “FFY ? 

2841 EES7 ces INY i YES, 

2842 EESS 81 15 LDA (BUFADR), Y iREAD HI BYTE BAD SECTOR DATA 
2843 EESA cs INY 

2844 EESB C9 FF CMP #$FF 

2845 EESD DBO Fe BNE RDBAD iIS IT "FF" 3 

2846 EESF 988 DEY 

2847 EE4&0 88 DEY i YES, 

2848 EE41 sc 08 O03 STY DBYTLO iPUT BAD SECTOR BYTE COUNT INTO DCB 
2849 EE64 Ag 00 LDA #0 

2850 EE66 8D 69 O63 STA DBYTHI 

2651 EE49 AC O93 03 ENDDIF: LDY DSTATS 

2852 EE4&C 40 RTS 

2853 i 

2854 i 

2855 F 

2856 i 

2857 3 SUBROUTINES 

2858 i 

2859 i 

2860 i PUT BUFFER ADDR FROM DCB INTO TEMP REG 

2841 i 

2662 EE6D AD 04 03 PUTADBR: LDA DBUFLO 

2863 EE70O0 85 15 STA BUFADR 

2864 EE72 AB O05 02 : LBA DBUFHI 

2865 EE75S 85 16 STA BUFADR+1 ;PUT BUFFER ADDR IN TEMP REG 
2844 EE77 4&6 RTS 

2867 ee ee ee ee eS eee ee Le ee! 
2868 i 

2869 i 

2870 3 SPARE BYTE OR MODULE TOO LONG FLAG 

2871 i 

2872 EE78 CRNTP4 = + 

2873 ; i 

2874 He ELA 


2875 0014 66 DSKSPR: . BYTE PRNORG-CRNTP4 ; “GDISKP TOO LONG 
2876 i 


ERR LINE 


2877 
2878 
2879 
2880 
2881 
2882 
2883 
2884 
2885 
2886 
2887 
2888 
2889 
2890 
2891 
2892 
2893 
2894 
2895 
2896 
2897 
2898 
2899 
29700 
29701 
2902 
2703 
2904 
2905 
2906 
2907 
2908 
2909 
2910 
2911 
2912 
2913 
2714 
2915 
2916 
2917 
2918 
2919 
2920 
2921 
2922 
2723 
2924 
2925 
2926 
2927 
2928 
2929 
2930 


ADDR Bi B2 B3 B4 


0002 
0028 
0014 
0o01D 
0040 


0057 
0020 
OO4E 
0044 
0053 


E430 
E432 
E434 
E436 
E438 
E434 
E43¢C 
E43F 


DISK 


ee ee ee ee ee ee Te oe Ce Td 


OPNOUT 
NBUFSZ 
DBUFSZ 
SBUFSZ 
PDEVN 

i STATC 
WRITEC 
SPACE 


ee ee ee ee Te ee Ty ie) o Zz. 


ee ee ee ee TT 


me ee meme 


eeeee DISKP. SRC saeeet G/9/79 eeeet 4:60:00 PAGE 64 
. PAGE 
. TITLE ‘PRINTER #444 PRINTP. SRC ###2% 3/9/79 s2eHe 4:00:00 P 


DEVICE NUMBER OR CODE EQUATES 


1 | | 


PRINTER 


$44 
$53 


iTOCB OPEN FOR OUTPUT COMMAND 
iPRINT NORMAL BUFFER SIZE 
iPRINT DOUBLE BUFFFER SIZE 
iPRINT SIDEWAYS BUFFER SIZE 
*#PRINTER DEVICE NUMBER 

+ DCB STATUS COMMAND CODE 

i+ DCB WRITE COMMAND 

iASCII SPACE CHAR. 

#ASCII “N" CHAR. 

;ASCII "DB" CHAR. 

;ASCITI "S" CHAR. 


HANDLER ENTRY POINTS 


#=$E 490 

. WORD PHOPEN-1 
. WORD PHCLOS-1 
. WORD BADST~—1 
. WORD PHWRIT-1i 
. WORD PHSTAT-i 
. WORD BADST-1 
JMP PHINIT 

. BYTE ie) 
#=PRNORG 


iPRINTER HANDLER OPEN 
iPH CLOSE 

iPH READ 

iPH WRITE 

iPH STATUS 

iPH SPECIAL 

iPH INIT. 

iROM FILLER 


PRINTER HANDLER INITIALIZATION ROUTINE 


ERR LINE 


273i 
2932 
2933 
2934 
2935 
2936 
2937 
2938 
2939 
29740 
27a 
2742 
2943 
2744 
2P745 
2974S 
2947 
2948 
294? 
2950 
2951 
2952 
2953 
2954 
2955 
2956 
2997 
29798 
2959 
29740 
2961 
2962 
2943 
29764 
2965 
2986 
2967 
2968 
2969 
2970 
2771 
2972 
2973 
2974 
2975 
2976 
2977 
2978 
2979 
2980 
2781 
2982 
2983 
2984 


ABDR 


EE78 
EE7A 
EE7C 


EE7D 
EEF 


EESF 
EEA2 
EEA4 
EEAG 


EEA7 
EEA? 
EEAC 


85 


A& 


B2 BS B4 


1E€ 
1¢ 


02 
O3 


81 
00 
1B 


iF 


1D 


EE 


EF 


PRINTER 
PHINIT: 


PHSTLO: 
PHCHLO: 


’ 


i 
j 
: 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 


HSTAT: 


BADST: 


in | ee ee 


HOPEN: 


“Oo ~ i ee ee ed 


HWRIT: 


HHHHH PRINTP. SRC #tHHH BS/O/7FD HHHHH 4:00 PAGE 65 
LDA #30 
STA PTIMOT iSET UP INITIAL PRINTER TIMEOUT OF 30 SEC. 


RTS 


PRINTER HANDLER CONSTANTS 


. WORD DYVSTAT i STATUS BUFFER POINTER 
. WORD PRNBUF iCHAR. BUFFER POINTER 


HKKARKARHARHAAHAAHHAHRHHH 


PRINTER HANDLER ROUTINES 
HME AEE EE 


PRINTER HANDLER STATUS ROUTINE 


LDA #4 

STA PBUFSZ iSET BUFFER SIZE TO 4 BYTES 
LDX PHSTLO 

LDY PHSTLO+i i SET POINTER TO STATUS BUFFER 
LDA #STATC iSET COMMAND TO “STATUS" 

STA BCOMND iSET STATUS COMMAND 

STA DAUX 1 

JSR SETDCB iGO SETUP DCB 

JSR SIov i SEND STATUS COMMAND 

BMI BADST ;GO IF ERROR 

JSR PHPUT i YES, PUT STATUS INTO GLOBAL BUFFER. 
RTS 


PRINTER HANDLER OPEN ROUTINE 


JSR PHSTAT iDO STATUS COMMAND TO SIO 
LBA #0 
STA PBPNT i CLEAR PRINT BUFFER POINTER 


RTS 


PRINTER HANDLER WRITE ROUTINE 


STA PTEMP i SAVE ACCUM 
JSR PRMODE ;GO DETERMINE PRINT MODE 
LDX PBPNT 


ERR LINE ADDR Bi Be BS B4 PRINTER ####% PRINTP. SRC ##24# 3/9/79 seeee 4:00 PAGE 66 


2985 EEAE AS iF LDA PTEMP iGET CHAR. SENT BY CIO 
298& EEBO 99D co 03 STA PRNBUF, X ;PUT CHAR. IN PRINT BUFFER 
2987 EEBS €8 INX i INCR. BUFFER POINTER 

2988 EEB4 €4 i€ CPX PBUFSZ i BUFFER POINTER=BUFFER SIZE? 
2989 EEB6 FO 13 BEG BUFFUL 

2990 EEBS 86 1B STX PBPNT i SAVE BUFFER POINTER 

2991 EEBA C9? 9B CMP #CR iIS CHAR. = EOL * 

2992 EEBC FO 03 BEG BLFILL i IF YES, GO DO BLANK FILL. 
2993 EEBE AO 01 LDY #SUCCES ;PUT GOOD STATUS IN Y REG FOR CIQ. 
2994 EECO 6G RTS 

29795 EECi A? 20 BLFILL: LDA #SPACE iPUT BLANK IN ACCUM. 

2996 EEC3 9B CO O03 FILLBF: STA PRNBUF, X i; STORE IT IN PRINT BUFFER. 
2997 EEC& ES INX 

2998 EEC7 €4 1E : CPX PBUFSZ 

2999 EEC? DOG FES BNE FILLBF i BUFFER BLANK FILLED? 

3000 EECB 4&9 CO BUFFUL: LDA #0 

3001 EECD 85 iB STA PBPNT i CLEAR PRINT BUFFER POINTER 
3002 EECF AE 7F EE LDX PHCHLO 

3003 EED2 AC 80 EE LDY PHCHLO+1 iSET POINTER TO PRINT BUFFER 
3004 EEDS 26 Eé EE JSR SETDCB iGO SETUP DCB 

3005 EEDS 320 59 E4 JSR Ssrov iSEND PRINT COMMAND 

3006 EEDB 46 RTS i YES. 

3007 i 

3008 i 

3009 i 

3010 i 

3011 i PRINTER HANDLER CLOSE ROUTINE 

3012 i 

S013 EEDC 2C¢ iA EF PHCLOS: JSR PRMODE iGO DETERMINE PRINT MODE 
3014 EEDF <Aé iB LDX PBPNT 

3015 EEE DBC DE BNE BLFILL 

3016 EEES 46 G1 LDY #SUCCES 

3017 EEES 66 RTS 

3018 ; 

3019 i 

3020 F 

3021 ; 

3022 i 

3623 ; 

3024 i 

3025 i 

3026 i SUBROUTINES 

3027 i 

3626 i 

3029 i 

3030 i 

3631 F 

3032 i SET UP BCB TO CALL SIO 

3033 i 

3034 EEE6 BE 04 03 SETBDCB: STX DBUFLO 

3035 EEE9 8c 6S 03 STY DBUFHI iSET BUFFER POINTER 

3036 EEEC A? 46 LDA #P DEVN 

3037 EEEE 8D 00 03 STA DDEVIC iSET PRINTER BUS I.DBD. FOR DCB 


3038 EEFL A? O1 LDA #1 


ERR LINE 


3039 
3040 
3041 
3042 
3043 
3044 
3045 
3646 
3047 
3048 
3049 
3050 
3051 
3052 
3053 
3054 
3055 
3056 


ADDR 


EEF3 
EEF6 
EEFS 
EEFB 
EEFD 
EEFF 
EFOI 
EFO4 
EFOS6 
EFOQ9 
EF OB 
EFOE 
EF1i0O 
EF1G 


EF14 
EF17 
EF19 


EFLA 
EFiC 
EFLE 
EF 20 
EF22 
EF24 
EF26 
EF 28 
EF2A 
EF2C 
EF2E 
EF3O 
EF 32 
EF 34 
EF36 
EF39 
EF3C 
EF3D 
EFSF 


AD 


60 


EC 
1¢ 


B3 B4 
03 


O03 


03 


PRINTER #2222 PRINTP. SRC #4282 3/9/79 Heeee 4:00 PAGE 
STA DUNIT i SET UNIT NUMBER TO 1 
LDA #3680 i DEVICE WILL EXPECT DATA 
LDX DCOMND 
CPX #STATC ; STATUS COMMAND? 
BNE PSIOC 
LDA #446 i EXPECT DATA FROM DEVICE 
PSIOC: STA DSTATS i SET SIO MODE COMMAND. 
LDA PBUFSZ 
STA BBYTLO >SET LO BYTE COUNT 
LDA #6 
STA DBYTHI iSET HI BYTE COUNT 
LDA PTIMOT 
STA DTIMLO i; SET DEVICE TIMEOUT COUNT 
RTS 


GET DEVICE TIMEOUT FROM STATUS & SAVE IT 


ba 3 | ee ee 


HPUT: LDA DVSTAT+2 
STA PTIMOT i SAVE DEVICE TIMEOUT 
RTS 
i 
i DETERMINE PRINT MODE & SETUP PRINT BUFFER SIZE, DCB PRINT 
i COMMAND, &% DCB AUXi FOR PRINT MODE 
PRMODE: LDY #WRITEC +PUT WRITE COMMAND IN Y REG 
LDA ICAX2Z iREAD PRINT MODE 
CMODE: CMP #N 
BNE CDUBL iPRINT NORMAL ? 
LDX #NBUFSZ i YES, SET NORMAL CHAR. BUFFER SIZE 
BNE SETBSZ 
CDUBL: CMP #D 
BNE CSIDE iPRINT DOUBLE? 
LDX #DBUFSZ i YES. SET DOUBLE CHAR. BUFFER SIZE 
BNE SETBSZ 
CSIDE: CMP #S iPRINT SIDEWAYS ? 
BNE GOERR i IF NOT, GO TO ERROR ROUTINE 
LDX #SBUFSZ ;YES, SET SIDEWAYS BUFFER SIZE 
SETBSZ: STX PBUFSZ i STORE PRINT BUFFER SIZE 
STY DCOMND i STORE DCB COMMAND 
STA DAUX1 i STORE DCB AUX1 PRINT MODE 
RTS 
GOERR: LDA #N ;SET DEFAULT PRINT MODE TO NORMAL 
BNE CMODE 


HAHAHAHAHAHA HHRAHEHAHHRHAHHKALHERHARHHAHHAHRRKREHKHRHHHHRRHKRHHHHRE 


SPARE BYTE OR MODULE TOO LONG FLAG 


i 
i 
i 
i 
: 


&7 


ERR LINE 


3093 
3094 
3095 
3096 
3097 
3098 


ADDR 81 Be BS B4 


EF4i 


0014 06 


PRINTER x###2 PRINTP. SRC wieee G/9/79 eeeee 4:00 


CRNTPS = * 


#=$14 


PRNSPR: . BYTE CASORG-CRNTPS ;*GPRINTP TOO LONG 


PAGE 


ERR LINE ADDR Bi Be BS B4 PRINTER ##### PRINTP. SRC #2422 G/9/79 HeHee 4:00 PAGE 


3099 . PAGE 

31006 .TITLE ‘CASSET HANDLER 3/12 (DK1: CASCYV>) ’ 
3101 0603 CBUFH = CASBUF /256 

3102 OOFD CBUFL = (-256)#C BUFH+CASBUF 

3103 006406 SRSTA = $40 ;SI0 READ STATUS 
3104 ocse SWSTA = $80 i;SIO0 WRITE STATUS 
3105 iMOTRGO = $34 

3106 iMOTRST = $3C 

3107 i 

3108 i 

3109 OOGFC DTA = $FC iDATA RECORD TYPE BYTE 
3110 OOFA DTi = $FA iLAST BATA RECORD 
3111 OOFE EQT = $FE + END OF TAPE 

3Sii2 OOFB HDR = $F B i HEADER 

3113 0002 TONE 1 = 2 i CHANGE TO RECORD MODE TONE 
3114 oOooi TONE2 = 1 ;PRESS PLAY TONE 

3115 i 

3116 i 

3117 i 

3118 #=CASETV 

3119 E440 48 EF 2A FO . WORD OPENC~1, CLOSEC~1, GBYTE-1, PBYTE-1i, STATU-1, SPECIAL~1 
3120 £444 BS EF OF FO 

Si2i E448 27 FO 44 EF 

3i2e E44C 4C 41 EF JMP INIT 

3123 E44F 60 . BYTE ie) ;ROM FILLER BYTE 

3124 i 

3125 i 

3126 ; 

3127 ; USED IN MONITP FOR CASSETTE BOOT 

3128 i 

3129 , #=RBLOKV 

3130 E47A 4C EF? EF JMP RBLOK 

313i i 

3132 *#=CSOPIV 

3133 €47D 4C SD EF JMP OP INP 

3134 i 

3135 i 

3136 #=CASORG 

3137 i 

3138 i 

3139 i INIT ROUTINE 

3140 i 

3141 EF41 A? CC INIT: LDA #$CC 

3142 EF43 8D EE 02 STA CBAUDL 

3143 EF46 A? OS LBA #$05_ 

3144 EF48 8D EF O02 STA CBAUDH i SET CASSET BAUD RATE TO 4600 
3145 SPECIAL: i THATS ALL FOLKS 


3146 EF4B 6&0 RTS 


ERR LINE 


3147 
3148 
a149 
3150 
3151 
3152 
3153 
3154 
3155 
3156 
3157 
3158 
3159 
3160 
3161 
3162 
3163 
3164 
3165 
3166 
3167 
3168 
2169 
3170 
3171 
3172 
3173 
3174 
3175 
3176 
3177 
3178 
3179 
3180 
3181 
3182 
3183 
3184 
3185 
3186 
3187 
3188 
3189 
3190 
Sigil 
3192 
3193 
3194 
BS1i9s 
3196 


3197 


3198 
G1i99 
3200 


ADDR 


EF4C 
EF 4E 
EFSO 
EFS2 
EFS4 
EFS6 
EFS8 
EFSA 
EFSC 
EFSD 
EF SF 
EF 42 
EF 44 
EF 46 
EF 69 
EF 6B 
EF 4D 


EF 70 
EF 72 


EF74 
EF 76 
EF79 
EF7C 
EF 7F 
EFS 1 
EF83 
EF@S 
EF S88 


EFSB 
EFaD 
EFSF 
EF91 
EFO4 


EF9S 


_ EF97 


EF9A 
EFSC 
EF OF 
EFAL 
EFAS 


Bi 


B2 BS B4 


02 


FO 


D3 


02 


CASSET HANDLER 3/712 (DK1: CASCV) 


i 


. PAGE 


PAGE 70 


i; OPEN FUNCTION - WITH NO TIMING ADJUST 


OPENC: 


OP INP: 


SFH: 


WAITTM: 


i 


LDA 
STA 
LDA 
AND 
CMP 
BEG 
CMP 
BEG 
RTS 
LDA 
STA 
STA 


ICAX2Z 
FYYPE 
ICAX1iZ 
#50C 
#$04 
OP INP 
#$08 
OPOUT 


#0 
WMODE 
FEOF 
#TONE2 
BEEP 
OPNRTN 
#MOTREO 
PACTL 
PALFLG 


PALFLG-1 


#$40 
#2 


; OPEN FOR OUTPUT 


PBRK: 


OPNRTN: 


OPOUT: 


LDY 
DEC 
LDA 
STA 
RTS 


LDA 
STA 
LDA 
JSR 
BMI 
LDA 
STA 


#BRKABT 


iGET AX2 
i SAVE IT FOR FUTURE REFERENCE 


i IN AND OUT BITS 


i SEE IF OPEN FOR OUTPUT 
+ IF ALREADY OPEN, RETURN LEAVING STATUS=$84 
i SET READ MODE 

;#NO EOF YET 

i; TONE FOR PRESS PLAY 

iGO BEEP 

i IF ERROR DURING BEEP 


i TURN MOTOR ON 


; 5-31-79 9 SEC READ LEADER 


i SET UP VBLANK TIMER 
iWAIT FOR MOTOR TO COME UP TO SPEED 
iNEXT BYTE=NO BYTES IN BUFFER 


i; OPEN OK 


i BREAK KEY ABORT STATUS 
i RESET BREAK KEY 
i CLEAR WRITE MODE FLAG 


; AND EXIT. 
;SET WRITE MODE 

; TELL USER TO TURN ON RECORD MODE 
; IF ERROR DURING BEEP 


i SET BAUD RATE 
iWHICH SEEMS TO BE NESSECARY 


ERR LINE 


3201 
3202 
3203 
3204 
3205 
3206 
3207 
3208 
3209 
3210 
geii 
3212 
3213 
3214 
3215 
3216 
3217 
3218 
3219 
3220 
ge2i 
3222 
3223 
3224 
3225 
3ea26 
3227 


ADDR 


EFAS 
EFAS 
EFAB 
EFAD 
EFBO 
EFBS 
EFBS 
EFBS 


EFBA 
EFBC 


EFBE 
EFCi 
EFC3 
EFCS 
EFCS 
EFCA 
EFCD 
EFCF 
EFD1 
EFD3 
EFDS 


E4 


02 


02 


CASSET HANDLER 3/712 (BK1i: CASCV> PAGE 
LDA #$05 +FOR SOME OBSCURE REASON 
STA AUDF4 
LDA #$40 
STA DDEVIC 
JSR SENDEV i TELL POKEY TO WRITE MARKS 
LDA #MOTRGO iWRITE 5S SEC BLANK TAPE 
STA PACTL 
LDA #3 
LF PALFLG 
LDX #$3 
LDY #3C0 
ENDIF 
. IF PALFLG-i 
LDX #4 15/30/79 20 SEC LEADER 
LDY #380 
. ENDIF 
JSR SETVBYV 
LDA #$FF 
STA CDIMFS 
WDLR: LDA BRAKEY 
BEG PBRK i IF BREAK DURING WRITE LEADER 
LDA CDTMFS 
BNE WDLR 
LDA #0 i INIT BUFFER POINTER 
STA BPTR 
OPOK: LDY #SUCCES 


71 


ERR LINE 


3228 
3229 
3230 
3231 
3232 
3233 
3234 
3235 
3236 
3237 
3238 
3239 
3240 
3241 
3242 
3243 
3244 
3245 
3246 
3247 
3248 
3249 
3250 
3251 
3252 
3253 
G254 
3255 
3256 
3257 
3258 


ADDR 


EFD6 
EFDS 
EFDA 
EFDC 
EF DF 
EFE1 
EFE4 
EFEG 
EFES 
EFE9? 
EFEB 
EFEE 
EFEF 
EFF 1 
EFFS 
EFFS 
EFF 7 
EFFA 
EFFC 
EFFE 
FOOO 
FOO2 
FOOS 
FOOS 
FOOB 
FOOD 
FOOF 


Bi 


Ba 


B3 B4 


04 


FO 


O03 


CASSET HANDLER 3/12 (DK1i: CASCYV) PAGE 


; 


. PAGE 


i GET BYTE 


GBYTE: 


GBX: 
RBLOK: 


NLR: 


ATEOF: 
ISEOF: 


LDA 
BMI 
LDX 
CPX 
BEG 
LDA 
INC 
LDY 
RTS 
LDA 
JSR 
TYA 
BMI 
LDA 
STA 
LDX 
LDA 
CMP 
BEG 
CMP 
BNE 
LDX 
STX 
JMP 
DEC 
LDBY 
RTS 


FEOF 

ISEOF 

BPTR 

BLIM 
RBLOK 
CASBUF+3, X 
BPTR 
#SUCCES 


#$80 
CASBUF+2 
#E0T 
ATEOF 
#DT 1 

NLR 
CASBUF+130 
BLIM 
GBYTE 
FEOF 
#E0OFERR 


i IF AT EOF ALREADY 
+RETURN EQF STATUS 
;BUFFER POINTER 

i IF END OF BUFFER 
iREAD ANOTHER BLOCK 
iGET NEXT BYTE 

i BUMP POINTER 

iOK# STATUS 


iREAD OPCCDE 
i510 ON SYS BUF 


i IF SIO ERRORS, RETURN 

iRESET POINTER 

i DEFAULT # BYTES 

i IF HEADER, GO READ AGAIN 

i IF LAST DATA REC 

iLAST BATA RECORD, GET # BYTES 
iGET NEXT BYTE 


i SET FEOF 
iENDFILE STATUS 


72 


ERR LINE 


3259 
3260 
3261 


ADDR 


FO1O 
FOi2 
FOIS 
FOL7 
FO19 
FO1B 
FO1D 


FOLE 
FO20 
FO23 
FO25 
FO27 


Bi 


Be BS B4 


04 


FO 


i 


i 


CASSET HANDLER 3/12 (DK1: CASCY> PAGE 


. PAGE 


PUT BYTE TO BUFFER 


PBYTE: 


; 


WRITE 


LDX 
STA 
INC 
LDY 
CPX 
BEG 
RTS 
OUT 
LDA 
JSR 
LDA 
STA 
RTS 


THE 


BPTR 
CASBUF +3, X 
BPTR 
#SUCCES 
#127 

#4+3 


BUFFER 
#DTA 


iBUFFER POINTER 
i STORE CHAR AWAY 
i BUMP POINTER 
iOK STATUS 

i IF BUFFER FULL 


*#RECORD TYPE = DATA 
;DO WRITE ON SYSTEM BUFFER 


;RESET BUFFER POINTER 
iEXIT. 


73 


ERR LINE ADDR Bi Be BS B4 CASSET HANDLER 3/712 (BK1: CASCYV) PAGE 74 


3276 . PAGE 


3277 i 

3278 i STATUS — RETURN STATUS INFO THRU. DVSTAT 
3279 i 

3280 FO2B AC Ol STATU: LDY #SUCCES 


3281 FO2A 4&0 RTS 


ERR LINE 


3282 | 


3283 
3284 
3285 
3286 
3287 
3288 
3289 
3290 
3291 
3292 
32993 
3294 
3295 
3294 
3297 
3293 
3299 
3300 
3301 
3302 
3303 
3304 
3305 
3306 


ADDR 


FO2B 
FO2E 


FO30 
FO32 
FO34 
FOQ37 
FO38 
FO3A 
FO3C 
FOSF 
FO41 
FO44 
FO46 
FO48 
FO4&A 
FO4D 
FO4E 
FOSO 
FOS2 
FOSS 


Bi 


B2 


B3 B4 


02 


D3 


04 


FO 


04 


FO 
FO 


CASSET HANDLER 3/12 (DK1: CASCV) PACE 75 
_ PAGE 
; CLOSE 
CLOSEC: LDA WMODE ;SEE IF WRITING 
BMI CLWRT ;GO CLOSE FOR WRITE 
; CLOSE FOR READ - FLAG CLOSED 
LDY #SUCCES ; SUCCESSFULL 
FCAX: LDA #MOTRST ;STOP THE MOTOR IN CASE WAS SHORT IRG MODE 
STA PACTL 
RTS 
CLWRT: LDX BPTR ; BUFFER POINTER 
BEG WTLR i IF NO BATA BYTES IN BUFFER, NO DT1 REC 
STX CASBUF+130 ;WRITE TO LAST RECORD 
LDA #DT1 ;REC TYPE 
JSR WSIOSB ; WRITE OUT USER BUFFER 
BMI FCAX ;GO IF ERROR 
WTLR:  LDX #127 ; ZERO BUFFER 
LDA #0 
ZTBUF: STA CASBUF+3, X 
DEX 
BPL. ZTBUF 
LDA #E0T ;WRITE EOT RECORD 
JSR WSIOSB . 
JMP FCAX ;FLAG CLOSED AND EXIT 


ERR LINE 


3307 
3308 
3309 
33106 
3311 
3312 
3313 
3314 
3315 
3316 
3317 
3318 
3319 
3320 
3321 
3322 
3323 
3324 
3325 
3326 
3327 
3328 
3329 
3330 
3331 
3332 
3333 
3334 
3335 
3336 
3337 
3338 
3339 
3340 
3341 
3342 
3343 
3344 
33495 
3346 
3347 
3348 
3349 
3350 
3351 
3352 
3353 
3354 
3359 
3356 
3357 
3358 
3359 
3360 


ADDR 


FOS8 
FOSA 
FOSC 


FOSD 


FOSF 
FO60 
FO62 
FOSS 
FO67 
F049 
FO6A 
FO6éC 
FOGF 
FO71 
FO72 
FO74 
FO76 
FO78 
FO7A 
FO7C 
FO7D 


FO7E 


FORO 
FOB4 
FOR3 
Foss 
FO87 
FOBA 
FOSB 
FOBC 
FOBF 
FO90 
FO93 
FO94 


Bi 


B2 BS B4 


40 
14 


iF DO 


1F DO 


CASSET HANDLER 3/12 (BK1i: CASCV) PAGE 


i 
i 
; 
; 
i 


BEEP: 
BEEP 1: 


WFL: 


. PAGE 


SUBROUTINES 


BEEP —- GENERATE TONE ON KEYBOARD SPEAKER 
ON ENTRY A= FREG 


FREG 
RTCLOK+2 i CURRENT CLOCK 


PALFLG 
#25 


PALFLG~-i 
#30 ii SEC TONE 


CONSOL i TURN ON SPEAKER 


#—-1 
CONSOL i TURN OFF SPEAKER 
#$FC 


a 
RTCLOK+2 iSEE IF 1 SEC IS UP YET 
WEL 


“FREQ i COUNT BEEPS 


WFAK i IF ALL DONE GO WAIT FOR KEY 


PALFLG 
#8 


PALFLG-i 
#10 


RTCLOK+2 

#-2 

BEEPi i UNCOND GO BEEP AGIN 

WFAKI iUSE SIMULATED "JMP (KGETCH)" 


KEYBDV+5 


KEYBDV+4 i SIMULATE "JMP (KGETCH?" 


i SIOSB - CALL SIO ON SYSTEM BUFFER 


ERR LINE 


3361 
3362 
3363 
3364 
3365 
3366 
3367 
3368 
3369 
3370 
3371 
3372 
3373 
3374 
3375 
3376 
3377 
3378 
3379 
3380 
3361 
3382 
3383 
3384 
3385 
3386 
3387 
3388 
3389 
3390 
33971 
3392 
3393 
3394 
3395 
3396 
3397 
3398 


ADDR 


FO9S 
FO98 
FO9A 
FO9D 
FOOF 
FOA2 
FOA4 
FOA7 
FOA? 
FOAC 
FOAE 
FOB1 
FOB3 
FOBS 
FOBB 
FOBB 
FOBE 
FOCO 
FOC2 
FOC4 
FOC6 
FOC9 
FOCB 
FOCE 
FOD1 


FOD2 
FODS 
FOD7 
FODA 
FODD 
FODF 
FOE2 
FOES 


0014 


B32 B4 


03 


03 


03 


03 


03 


03 


03 


03 
03 


03 


63 
E4 


03 


o3 
03 


FO 


CASSET HANDLER 3712 (BAL: CASCYV) PAGE 
SIOSB: STA DBDCOMND i SAVE COMMAND 
LDA #0 
STA DBYTHI i SET BUFFER LENGTH 
LDA #131 
STA DBYTLO 
LDA #CBUFH 
STA DBUFHI iSET BUFFER ADDRESS 
LDA #C BUFL 
STA DBUFLO 
csio: LDA #460 iCASSET PSEUDO DEVICE 
STA DDEVIC 
LDA #6 
STA DUNIT 
LDA #35 iDEVICE TIMEOUT (5/30/79) 
STA DTIMLO 
LDA DCOMND iGET COMMAND BACK 
LDY #SRSTA iSIO READ STATUS COMMAND 
CMP #°R 
BEG +4 
LDY #SWSTA i SIO WRITE STATUS COMMAND 
‘STY DSTATS iSET STATUS FOR SIO 
LDA FTYPE 
STA DAUX2 i INDICATE IF SHORT IRG MODE 
JSR Stov iGO CALL SIO 
RTS 


; 


i WSIOSB ~—- WRITE SIO SYSTEM BUFFER 


WSIOSB: 


CRNTPS 


CASSPR: 


STA 
LDA 
STA 
STA 
LDA 
JSR 
RTS 
matt 
#=$14 
_ BYTE 


CASBUF+2 i STORE TYPE BYTE 

#$55 

CASBUF+6 

CASBUF+1 

#°W WRITE 

STOSB iCALL SIO ON SYSTEM BUFFER 
AND i RETURN 


MONORG-CRNTP4& i *GCASCV IS TOO LONG 


ERR LINE 


3399 
3400 
3401 
3402 
3403 
3404 
3405 
3406 
3407 
3408 
3409 
3410 
3411 
3412 
3413 
3414 
S415 
3416 


ADDR 


0009 
0007 
O0OB 
0000 
0007 


0000 
007D 
0092 
0088 
0000 


0004 
0000 


BFFA 
BFFC 
BFFD 
BFFE 


Bi Be BS B4 


CASSET HANDLER 3/712 (DK1i: CASCYV) PAGE 78 


TITLE ‘MONITOR s##2#%% MONITP. SRC ##e#% G/9O/79 HHHHH 4:00:00 P 
i CONSTANT EQUATES 


PUTTXT 


= $9 i "PUT TEXT RECORD" CIO COMMAND CODE 
GETCAR = $7 i“GET CHARACTER" CIO COMMAND CODE 
PUTCAR = $B i “PUT CHARACTER" CIO COMMAND CODE 
INIMLL = $00 i; INITIAL MEM LO LOW BYTE 
INIMLH = $07 i INITIAL MEM LO HIGH BYTE 
; GOOD = $1 ;GOOD STATUS CODE 
i WRITE = $57 iWRITE COMMAND 
; READ = $52 ;READ COMMAND 
i STATC = $53 i STATUS COMMAND 
SEX = $6 i SCREEN EDITOR IOCB INDEX 
CLS = $7D i CLEAR SCREEN CODE 
CTRLC = $92 i KEYBOARD CODE FOR ‘CONTROL C’ 
EOF = $88 iCASSETTE END OF FILE CODE 
LIRG = $0 iLONG IRG TYPE CODE 
BUFFH = (CASBUF+3) /256 
= (-254) #BUFFH+CASBUF+3 i; BUFFER POINTER 


BUFFL 


‘ 


THE FOLLOWING EQUATES ARE IN THE CARTRIDGE ADDRESS SPACE. 
“B" CARTRIDGE ABDDR‘’S ARE GSOQOO-9FFF (36K CONFIG. ONLY) 
"A" CART. ADDR‘'S ARE AOQOO-BFFF (36K CONFIG. ONLY) 


“A" CART. ADDR‘S ARE BOOO-BFFF (48K CONFIG. ONLY) 


; 
i 
i 
i 
i 
i 
' 
i 
i 
i 


#=$BFFA 
CARTCS: .RES 2 i CARTRIDGE COLD START ADDRESS. 
CART: . RES 1 i CARTRIDGE AVAILABLE FLAG BYTE. 
CARTFG: .RES 1 i CARTRIDGE FLAG BYTE. BIT O=FLAGI, 
2 i2-BYTE CARTRIDGE START VECTOR 


CARTAD: .RES 


a 


CARTRIDGE FLAG ACTION DEFINITIONS 


BIT ACTION IF SET 

7 SPECIAL -- DON’T POWER-UP, JUST RUN CARTRIDGE 
6-3 NONE 

2 RUN CARTRIDGE 

1 NONE 

Go BOOT BOS 


re eT ee ee PT Sa ed 


ERR LINE ADDR Bi Be BS B4 


3453 
3454 
3455 
3456 
3457 
3458 
3459 
3440 


E471 


E474 


E477 


9000 
9003 
9006 
9009 


4c 


4¢C 


23 


18 


Fa 


Fi 


ee ee ee TT Ce i Te eT 


MONITOR ##4%% MONITP. SRC #8244 3/9/79 #24e2%# 4:00 PAGE 79 


HERR 


NOTE 
HHEAH 


1.1F BIT2 IS G. GOTO BLACKBOARD MODE. 
2.1IF BITG SET. THE DISK WILL BE BOOTED BEFORE ANY 


OTHER ACTION. 


POWER-UP VECTOR 


HRARAHHHHHKHHAHRRAHKHHHHAHHAHRSE 


#=$FFFC 


PVECT . WORD PWRUP 
HHHHHHHHHRHHEHHHAEHHEAHEH 


ENTRY POINT VECTOR 


#=BLKBDV 

JMP SIGNON 
#=WARMSV 

JMP RESET 
#=COLDSV 

JMP PWRUP 
#= $9000 

JSR $900C 
JMP PWRUP 
JSR $900C 
JMP RESET 
#=MONORG 


POWER-UP VECTOR 


i BLACK BOARD VECTOR 


i WARM START VECTOR 


i; COLD START VECTOR (9000 FOR RAM VECTOR WRIT 


i (TO HANDLE RAM VECTOR WRITING) 


ERR LINE 


3507 
3508 
3509 
3510 
3511 
aSi2 
3513 
3514 
3515 
3516 
3517 
3518 
3519 
3520 
3521 
3522 
3523 
3524 
3525 
3526 


ADDR 


FOES 
FOE4 
FOEG 
FOE7 
FOE? 
FOEA 
FOEC 
FOED 
FOEF 
FOFO 


FOF2 
FOF6 
FOFA 
FOFE 
F102 
F106 
F10A 


OOFO 
OOF2 


OOOE 
F10D 
Fill 
F115 


OOF 1 
oO0O0D 


F118 


OOF 1 
0018 
F1iB 


Bi 


42 


4F 


4S 


Be BS B4 


E4 


E4 


E4 


E4 


E4 


4F 


92 


3A 


4F 
52 


9B 


94 
S2 


MONITOR ####+ MONITP. SRC ###44 3/9/79 xeeHee 4:00 PAGE 80 


i 


i HANDLER TABLE ENTRIES 


TBLENT: . BYTE. 


. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 


HHA 


DENT: .BYTE 


IDENTH 
IDENTL 


tow 


TBLLEN 
DERRS: .BYTE 


o., 
m 
2 
x 
< 

i ft 


OPNEDT: . BYTE 


OP NH 


‘pe 
PRINTY 
oa Osa 
CASETY 
‘ES 
EDITRYV 
"Sf 
SCRENY 
Ke 
KEYBBY 


IDENT-TBLENT-1 HANDLER TABLE LENGTH. "MOVED TO LINE 8 


PRINT MESSAGES siti 


CLS, ‘ATARI COMPUTER — MEMO PAD’. CR 


IDENT/256 
(-256)#IDENTH+IDENT ; SYSTEM I.D. MSG POINTER 


IDENT-TBLENT-1 ij HANDLER TABLE LENGTH 
‘BOOT ERROR’, CR 


DERRS/256 
(-2546) #DERRH+DERRS i; DISK ERROR MSG POINTER 


DEVICE/FILENAME SPECIFICATIONS 


‘E: °, CR ; “OPEN SCREEN EDITOR" DEVICE SPEC. 


OPNEDT/256 


OPNL =(~256)#0PNH+OPNEDT i; SCREEN EDITOR OPEN POINTER 


i 
i 
i 
i 
i 


j HHKHRHAEHKHAHRAHRARHRHHRHRHAKRHHEAHHE AKERS RERHHERARHEREHRHRHEHEHHHEHE 


ERR LINE ADDR Bi Be BS B4 MONITOR #242 MONITP. SRC ###%#2 3/9/79 ##Hee 4:00 PAGE Bi 


3541 ; RESET BUTTON ROUTINE STARTS HERE 

3542 j HHRHAKHKRKHAHHAHHAARAHHAAHHHHEHHHHHHHAEHHEHHHHKHHKFHKHARHHHHHHHERHRHHREH 
3563 i 

3564 F1i1B 78 RESET: SEI i DISABLE IRQ INTERRUPTS 
3565 Fiic ADB 44 02 LDA COLDBST ;WERE WE IN MIDDLE OF COLDSTART? 
3566 FiiF Bo 04 BNE PWRUP i YES, GO TRY IT AGAIN 

3567 Fi2i AG FF LDA #3FF 

3568 F123 BO 03 BNE PWRUP 1 i SET WARM START FLAG 

3549 i 

3570 i 

3571 j 

3572 jp RRR ARE HARKER AEHAAARAH AHHH HHHERHHEHHAREHHRHHRHEHRHRHEHHKRHHEEEH 
3573 i POWER UP ROUTINES START HERE 

3574 cc ee ee ee ee ee ee ee ee er ee re ee ee) 
3575 i 

3576 Fi25 78 PWRUP: SEI i DISABLE IRQ INTERRUPTS 
3577 Fi2& Ag? OO LBA #0 i CLEAR WARMSTART FLAG 

3578 F128 85 08 PWRUP1: STA WARMST 

3579 Fi2A bs CLD i CLEAR DECIMAL FLAG. 

3580 F1I2B A2 FF LDX #$FF 

3581 Fi2D FA TXS iSET STACK POINTER 

3582 Fi2eE 20 BF F2 JSR SPECL i CARTRIDGE SPECIAL CASE? 
35983 Fi31l 20 77 F2 JSR HARDBI i; BDO HARDWARE INITIALIZATION 
3584 Fi34 A5 08 LBA WARMST iIS IT WARMSTART? 

3585 Fi3& DBC 26 BNE ZOSRAM i YES, ONLY ZERO OS RAM 

3586 i 

3587 Fi3e A? GO ZERORM: LDA #0 

3588 Fi3A ACG C8 LBY #WARMST 

3589 F13C 85 04 STA RAMLO 

359O FI3SE 85 05 STA RAMLO+1 i INITIALIZE RAM POINTER 
3591 F140 Fi 64 CLRRAM: STA C(RAMLO}, Y i CLEAR MEMORY LOC. 

3592 F142 C8 INY 

3993 Fi43 cc OG CPY #0 iAT END OF PAGE? 

3594 F145 bBo F9 BNE CLRRAM 

3595 F147 E& OS INC RAMLO+1 i YES, INCR PAGE POINTER 
359464 F149 A& OS LDX RAMLO+1 

3597 F1i4B E4& 06 CPX TRAMSZ i AT END OF MEM? 

3598 F14D DBO Fi BNE CLRRAM iNO. 

3599 i 

3400 ; INITIALIZE DOSVEC TO POINT TO SIGNON (BLACKBOARD) 
3601 F1I4F AD 72 £4 LDA BLKABDV+1 

3402 Fi52 85 OA STA DOSVEC ;USE BLACKBOARD VECTOR 

3603 F154 ADB 73 £4 LDA BLKABBDV+2 ;FOR DOSVEC 

3604 FiS7 85 OB STA DOSVEC+1 

3605 F159 Ad FF LDA #SFF 

3406 F158 8D 44 G2 STA COLDST +SET TO SHOW IN MIDDLE OF COLDSTART 
3607 FISE bC 13 BNE ESTSCM iGO AROUND ZOSRAM 

3608 ; 

3409 ; CLEAR OS RAM (FOR WARMSTART > 

3610 F160 A2 00 ZOSRAM: LDX #0 

3611 Fié2 8A TXA 

3412 Fi&3 9D 00 O02 ZOSRM2: STA $200, X i CLEAR PAGES 2 AND 3 

3613 Fi6& 9D CO OS STA $300, X 


3614 F169 CA DEX 


ERR LINE 


3615 
3416 
3617 
3618 
3619 
3420 
3621 
3622 
3623 
3624 
3625 
3426 
3627 
3628 
3429 
3630 
3631 
3632 
3633 
3634 
3635 
3436 
3637 
3638 
3639 
3640 
3641 
3642 
3643 
3644 
3645 
3646 
3647 
3648 
3649 
3650 
3651 
3452 
3653 
3454 
3655 
3656 
3657 
3658 
34597 
3640 
3661 
3662 
3663 
3664 
3665 
3646 
3667 
3668 


ADDR 


F1iédA 
F1idéC 
FI6E 
F170 
Fi71 


F173 
F175 
F177 
F179 


F17B 
Fi7D 
Fi80 
Fi83 
F184 
F186 
Fi89? 


FiBA 
Fisc 
Fier 
F192 
F193 


Fi?s 
F197 
F199 
F1i9B 
FI9E 
F1iAO 
Fide 
FLAS 
FLA7 
FLA? 


FLAC 
FLAF 
FiBi 
FiBS 
FiB6é 
FIBS 


B2 BS B4 


E4 
02 


Fe 


FO 
03 


02 


MONITOR 222% MONITP. SRC ##44% 3/9/79 See eH 4:00 


BNE 
LDX 
ZOSRM3: STA 
INX 
BPL 
i ESTABLISH 
ESTSCM: LDA 
STA 
LDA 
STA 


i 


ZOSRM2 
#INTZBS 
QO. X 


ZOSRMG 


SCREEN MARGINS 
#LEDGE 
LMARGN 
#REDGE 
RMARGN 


PAGE 


iCLEAR ZERO PAGE LOCATIONS INTZBS-7F 


i MOVE VECTOR TABLE FROM ROM TO RAM 


OPSYS: LDX 
MOVVEC: LDA 
STA 
DEX 
BPL. 
JSR 
CLI 


a Te Ty 


LDX 
NXTENT: LDA 
STA 
DEX 
BPL 


eT Te a Te Ta 


LDX 
STX 
STX 
LDX 
CPX 
BCS 
LDA 
BNE 
INC 
JSR 


ENDBCK: LDX 
CPX 
BCS 
LDX 
BNE 
INC 


#225 
VCTABL, X 
INTABS, X 


MOVVEC 
OSRAM 


LINK HANDLERS 


#TBLLEN 
TBLENT, X 
HATABS, X 


NXTENT 


INTERROGATE CARTRIDGE ADDR. 


#0 

TSTBAT 
TRAMSZ 
RAMS IZ 
#¢90 
ENDBCK 
CART-$2000 
ENDECK 
TSTDAT 
CBINI 


RAMS IZ 
#$BC 
ENDACK 
CART 
ENDACK 
TRAMSZ 


iROM TABLE 


+ TO RAM 


iDO 0.5. RAM SETUP 
iENABLE IRQ INTERRUPTS 


i READ HANDLER TABLE ENTRY 


i#PUT IN TABLE 


i DONE WITH ALL ENTRIES? 


i CLEAR 
i CLEAR 


iRAM I 


i NO, 


epee 
tA 


N wpe 


CART. FLAG 
CART. FLAG 


CART. SLOT? 


i CART. PLUGGED INTO “B" 


i YES, 


SET 


“B" CART. FLAG 


i INITIALIZE CARTRIDGE "B 


iRAM IN “A" CART. SLOT? 

i NO, 

i CART. PLUGGED INTO "A" 

+ YES, SET "A" CART. FLAG 


SLOT? 


SLOT? 


B2 


SPACE TO SEE WHICH CARTRIDGES THERE ARE 


ERR LINE ADDR Bi Be BS B4 MONITOR ##+2% MONITP. SRC ##2%% 3/9/79 zueee 4:00 PAGE 83 


3649 FIBA 20 39 F2 JSR CAINI i INITIALIZE CARTRIDGE "A" 
3670 i 

3471 i 

3672 + OPEN SCREEN EDITOR 

3673 i 

3674 FIBD A? 03 ENDACK: LDA #3 

3675 FIBF Aé2 00 LDX #SEX 

3476 FiCi 7D 42 03 STA ICCOM, X i; OPEN 1/0 COMMAND 

3677 FicC4 AG 18 LDA #0PNL 

3478 F1iC& 7D 44 03 STA ICBAL., X 

3679 FiC9 AD Fi LDA #0P NH 

3680 FICB 9B 45 03 STA ICBAH, X iSET BUFFER POINTER TO OPEN SCREEN EDITOR 
3681 FICE A? OC LDA #5C 

3682 F1iDO SDB 4A 03 STA ICAX1L, X iSET UP OPEN FOR INPUT/OUTPUT 
3683 FIDS 20 56 €4 JSR croyv iGO TO CIO 

3684 i 

3685 FiDS 16 03 BPL. SCRNOK iBR IF NO ERROR 

3686 FiDS 4¢C 25 Fi JMP PWRUP ;RETRY PWRUP IF ERROR (SHOULD NEVER HAPPEN! >} 
3687 FiIDB E8 SCRNOK: INX i SCREEN OK, SO WAIT FOR VBLANK TO 
3688 FiDC Bo FB BNE SCRNOK i BRING UP THE DISPLAY 

3689 FIDE C8 INY 

3690 FIiDF 10 FA BPL SCRNOK 

3491 i 

3492 5 

3693 i DO CASSETTE BOOT 

3694 FiEi 20 Be F3 JSR CSBOOT iCHECK, BOOT, AND INIT 

3495 i 

3694 i CHECK TO SEE IF EITHER CARTRIDGE WANTS DISK BOOT 

3697 FiE4 AS G64 LDA TRAMSZ i CHECK BOTH CARTRIDGES 

3698 FiE6& GS 67 ORA TSTBAT i 

3699 FIES FO 12 BEG NOCART i NEITHER CARTRIDGE LIVES 
3700 FIiEA AS 06 LDA TRAMSZ i "A" CART? 

3701 FIiEC FOG O63 BEG NOAL iNO 

3702 FIiEE AD FD BF LDA CARTFG iGET CARTRIDGE MODE FLAG 
3703 FIFi A& 07 NOAL: LDX TSTDAT i“B" CART? 

3704 FiF3 FC O03 BEG NOB1 iNO 

3705 FiF5S OD FD 9F ORA CARTFG-$2000 ; ADD OTHER FLAG 

3706 FiFB 29 O1 NOB1: AND #1 i DOES EITHER CART WANT BOOT? 
3707 FIFA FG O93 BEQ NOBOOT i NO 

3708 i 

3709 ; BO DISK BOOT 

3710 FiFC 20 CF F2 NOCART: JSR BOOT iCHECK, BOOT, AND INIT 

3711 i 

3712 i GO TO ONE OF THE CARTRIDGES IF THEY SO DESIRE 

3713 ‘FiFF aA? 60 NOBOOT: LDA #0 

3714 F201 8b 44 C2 STA COLDST i RESET TO SHOW DONE WITH COLDSTART 
3715 F204 AS 06 LDA TRAMSZ i“A" CART? 

3715 F206 FOG OA BEG NOAS i NO 

3717 F208 AB FD BF LDA CARTFG iGET CARTRIDGE MODE FLAG 
3718 FeOB 29 04 AND #4 iDOES IT WANT TO RUN? 

3719 F2OD FO 03 BEG NOA2 iNO 

3720 F2O0F 4C FA BF JMP (CARTCS} iRUN “A” CARTRIDGE 

3721 Fei2 AS 07 NOA2: LDA TSTBAT i“B" CART? 


3722 F2i4 FG OA BEG NOCARS iNO 


ERR LINE 


3723 
3724 
3725 
3726 
3727 
3728 
3729 
3730 
3731 
3732 
3733 
3734 
3735 
3736 
3737 
3738 
3739 
3740 
3741 
3742 
3743 
3744 
3745 
3746 
3747 
3748 
3749 
3750 
3751 


&C 
&C 


FE 
FE 


BS B4 


oF 


oF 


00 


FS 


Fe 
F2 
E4 


E4 


BF 
oF 


MONITOR s#%#2#2 MONITP. SRC x#e48 3/9/79 sexHee 4:00 


LDA 
AND 
BEG 
JMP 


; 


i NO CARTRIDGES, 


CARTFG-$2000 ;GET "B" MODE FLAG 
#4 ;DOES IT WANT TO RUN? 
NOCART i NO 

(CARTCS-$2000) ; RUN "B" CARTRIDGE 


OR NEITHER WANTS TO RUN, 


; $0 GO TO DOSVEC (BOS. CASSETTE. OR BLACKBOARD) 


NOCAR2: JMP 


2 


(DOSVEC 3 


i PRINT SIGN-ON MESSAGE 


SIGNON: LDX 
LDY 
JSR 


td ee ee Te Ty 


LACKB: JSR 
JMP 
BLKAB2: LDA 
PHA 
LDA 
PHA 
RTS 
i CARTRIDGE 
CAINI: JMP 
CBINI: JMP 


#IDENTL 
#IDENTH 


PUTLIN ;GO PUT SIGN-ON MSG ON SCREEN 


BLACKBOARD ROUTINE 


BLKB2 i "JSR EGETCH" 
BLACKB i FOREVER 
EDITRV+5 iHIGH BYTE 
EDITRV+4 iLOW BYTE 


iSIMULATES "JMP (EDITRV)" 


INITIALIZATION INDIRECT JUMPS 


(CARTAD) 
(CARTAB-$2000 } 


PAGE 


84 


ERR LINE 


3752 
3793 
3754 
3755 
3756 
3757 


ADDR Bi B2 BS B4 


F23F 
F242 
F244 
F247 
F24a 
F24C 
F24F 
F251 


F254 
F257 
F259 
F25B 
F25D 
F2SF 
F2él 
F263 
F265 
F267 
F269 
F26B 
F26D 


BF 


BF 
BF 


BF 


BF 


BF 


MONITOR 


. PAGE 


SUBROU 


IF SPECIAL CARTRIDGE CASE, 


j 
j 
j 
ij 
j 
F 
j 
j 
F 
. 
; 
i 
i 
i 
i 
i 
: 
i 
i 
i 
i 
i 
i 
i 
. 
i 
i 
. 
i 
i 
i 
i 


PECL: LDA CART 
BNE ENSPE2 
INC CART 
LDA CART 
BNE ENSPEC 
LDA CARTFG 
BPL ENSPEC 
JMP (CARTAD?} 


CHECK FOR AMOUNT OF RAM 


a er Td 


ENSPEC: DEC CART 
ENSPE2: LDY #0 
STY RAMLO+1 
LDA #10 
STA TRAMSZ 
HOWMCH: LDA (RAMLO+1>, Y 
EOR SEF 
STA (RAMLO+1). ¥ 
CMP (RAMLO+1>,Y 
BNE ENDRAM 
EOR #$FF 
STA (RAMLO+13,¥ 
LDA TRAMSZ 


HHHHH MONIT. SRC #eeeH S/O/7F HHHHE 


4:00 PAGE 


TINES 


CHECK FOR HOW MUCH RAM &% SPECIAL CARTRIDGE CASE. 


DON‘T GO BACK -- GO TO CART. 


i CHECK FOR RAM OR CART 

iGO IF NOTHING OR MAYBE RAM 
iNOW DO RAM CHECK 

ils IT ROM? 

iNO 

; YES, 

i;BIT SET? 

i YES. GO RUN CARTRIDGE 


iRESTORE RAM IF NEEDED 


*#SET RAM POINTER TO 4K. 
iREAD RAM LOCATION 

i INVERT IT. 

iWRITE INVERTED DATA. 
iREAD RAM AGAIN 


i; CONVERT IT BACK 
;RESTORE ORIGINAL RAM DATA 
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ERR LINE 


3804 
3807 
3808 
3809 
3810 
S8i1 
3812 
3813 
3614 
3815 
3816 
3817 
3818 
3819 
3820 
3821 
3822 
3823 
3824 
3825 
3826 
3827 
3828 
3829 
3830 
3831 
3832 
3833 
3834 
3835 
3836 
3837 
3838 
3839 
3840 
3641 
3842 
3843 
3844 
3845 
3846 
3847 
3848 
3B49 
3850 
3851 
3852 
3853 
3854 
3855 
3856 
3857 
3858 
3859 


ADDR 


F24F 
F270 
F272 
F274 
F276 


F277 
F279 
FQ7A 
F27D 
F280 
F289 
F286 
F287 
F289 


F284 
F28C 
F28E 
F291 
F293 
F296 
F298 
F29B 
F29E 
F2A0 
F2ea3 
F2AS 
F2As8 
FAA 
F2AD 
F2BO 
F2B3 
F2B6 
F2B9 
Fe2BCc 
F2BF 
F2c2 
F2C5 
F2cs 
F2ecaé 
F2cc 
F2ce 


B2 B32 B4 


MONITOR 


ENDRAM: 


a ee Ty 


HARDI: 


CLRCHP: 


o- me eee 


SRAM: 


NOKEY: 


#eeee% MONITP. SRC saat 3/9/79 weeee 4:00 PAGE 
CLC 
ADC #$10 
STA TRAMSZ i INCR. RAM POINTER BY 4K. 
BNE HOWMCH iGO FIND HOW MUCH RAM. 
RTS 


HARDWARE INITIALIZATION 


LDA 
TAX 
STA 
STA 


#0 
$DOCO, X 
$D4G0, X 
$D200, X 
$DGCG, X 
CLRCHP 
RAM SETUP 
BRAKEY i TURN OFF BREAK KEY FLAG 
#. LOW. BRAKY2 
BRKKY 
#. HIGH. BRAKY2 
BRAKY+1 
TRAMSZ ;READ RAM SIZE IN TEMP. REG. 
RAMS IZ i SAVE IT IN RAM SIZE. 
MEMTOP+1 i INIT. MEMTOP ADDR HI BYTE 
#0 
MEMTOP i INIT. MEMTOP ADDR LO BYTE 
#INIMLL 
MEMLO 
#INIMLH 
MEMLO+ 1 i INITIALIZE MEMLO ADDR VECTOR 
EDITRV+$C *#EDITOR INIT. 
SCRENV+S$C i SCREEN INIT. 
KEYBDV+$C i; KEYBOARD INIT. 
PRINTV+$C iPRINTER HANDLER INIT 
CASE TV+$C i CASSETTE HANDLER INIT 
CIOINV iCIO INIT. 
SIOINY iSIO INIT. 
INTINY i INTERRUPT HANDLER INIT. 
CONSOL 
#S1 
NOKEY iGAME START KEY DEPRESSED? 
CKEY i YES, SET KEY FLAG. 
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ERR LINE ADDR Bi B2 B3 B4 MONITOR #2+##% MONITP. SRC sate 3/9/79 sexHee 4:00 PAGE 87 


3860 ; DO BOOT OF DISK 

3861 F 

3862 F2CF AS O08 BOOT: LDA WARMST 

9863 F2D1 FO OA BEG NOWARM i; WARM START? 

3864 F2D3 AS 09 LDA BOOT? i YES, 

3865 F2D5 29 O01 AND #1 

3866 F2D7 FG GS BEQ NOINIT *#VALID BOOT? 

3867 F2D9 20 7E F3 JSR DINI i YES, RE-INIT. DOS SOFTWARE 
3868 F2pCc 46 NOINIT: RTS : 
3869 F2DD A? O1 NOWARM: LDA #1 

3870 F2DF 8D O01 03 STA DUNIT i; ASSIGN DISK DRIVE NO. 

3871 F2E2 aA? 53 LDA #STATC 

3872 F2E4 8D 02 03 STA DCOMND ;SET UP STATUS COMMAND 

3873 F2E7 206 53 £4 JSR DSKINV iGO DO DISK STATUS 

3874 F2EA 106 O1 BPL DOBOOT i; 1S STATUS FROM SIO GOOD? 
3875 F2EC 640 RTS iNO. GO BACK WITH BAD BOOT STATUS 
3876 i 

3877 F2ED A? 00 DOBOOT: LDA #0 

3878 F2EF 8D OB 03 STA DAUX2 

3879 F2F2 AP O1 LDA #1 

3880 F2F4 8D OA 03 STA DAUX1 i SET SECTOR # TO 1. 

3881 F2F7 A? OO LDA #BUFFL 

3882 F2F9 SD 04 03 STA DBUFLO 

3883 F2FC Ag? 04 LDA #BUFFH 

3684 F2FE sb OS 03 STA DBUFHI iSET UP BUFFER ADDR 

3885 F301 20 9D F3 SECT1: JSR GETSEC ;GET SECTOR 

3884 F304 10 08 BPL ALLSEC ; STATUS O.K. 7? 

3887 F306 20 81 F3 BADDSK: JSR DSKRDE ;NO, GO PRINT DISK READ ERROR 
3888 F209 AS 4B LDA CASSBT 

3889 F30B FO EC BEG DOBOOT i; CASSETTE BOOT? 

3890 F30D 640 RTS i; YES, QUIT 

3891 FS0E A2 03 ALLSEC: LDX #3 

3892 F310 BD 00 04 RDBYTE: LDA CASBUF+3,X iREAD A BUFFER BYTE 

3893 F313 99D 40 02 STA DFLAGS, X ; STORE IT 

3894 F316 CA DEX 

3895 F317 10 F7 BPL RDBYTE ; DONE WITH 4 BYTE TRANSFER ? 
3896 F319 AB 42 02 LDA BOOTAD i; YES, 

3897 F31C 85 04 STA RAMLO 

3898 FS1E AD 43 02 LDA BOOTAD+1 

3899 F321 85 05 STA RAMLO+1 ;PUT BOOT ADDR INTO Z. PAGE RAM 
3900 F323 AD 04 04 LDA CASBUF+7 

3901 F326 85 0C STA DOSINI ; ESTABLISH DOS INIT ADDRESS 
3902 F328 AD 05 04 LDA CASBUF+8 

3903 F32B 85 oD STA DOSINI+1 

3904 F32D AO 7F MVBUFF: LDY #$7F i; YES, SET BYTE COUNT 

3905 F32F BF 00 04 MVNXB: LDA CASBUF+3, Y 

3906 F332 91 04 STA (RAMLO},Y  iMOVE A BYTE FROM SECTOR BUFFER TO BOOT ADDR 
3907 F334 88 DEY 

3908 F335 10 F8 BPL MYNXB ; DONE ? 

3909 F337 i8 CLC ; YES, 

3910 F338 AS 04 LDA RAMLO 

3911 F33A 49 80 ADC #$80 

3912 F33C 85 04 STA RAMLO 


3713 FO3SE AS O05 LDA RAMLO+1 


ERR LINE ADDR Bi Be BS B4 MONITOR #####% MONITP. SRC ##ae G/O/79 eeHee 4:60 PAGE 88 


3914 F340 49 GO ADC #6 

3915 F342 $85 65 STA RAMLO+1 i INCR BOOT LOADER BUFFER POINTER. 
3916 F344 ce 41 62 BEC DBSECT iDECR # OF SECTORS. 

3917 F347 FG li BEG ENBOOT iMORE SECTORS ? 

3918 F349 EF OA C3 INC DAUX1 i YES, INCR SECTOR # 

3919 F34C 20 9B F3 SECTX: USR GETSEC iGO GET SECTOR. 

3920 F34F 16 BC BPL MVBUFF i STATUS O.K. 7 

3921 F351 20 81 FS JSR DSKARBE iNO, GO PRINT BISK READ ERROR 
3922 F354 AS 48 LDA CASSBT 

3923 F356 DG AE BNE BADDSK i IF CASSETTE, QUIT. 

3924 F358 FG F2 BEG SECTX i IF DISK, TRY SECTOR AGAIN. 
3925 F3SA AS 4B ENBOOT: LDA CASSBT 

3926 F35C FO 03 BEG XBOOT i CASSETTE BOOT * 

3927 F3SSE 2C 9D FS JSR GETSEC i; YES, GET EOF RECORD, BUT DON’T USE IT. 
3928 F361 320 4&C FS XBOOT: JSR BLOAB iGO EXECUTE BOOT LOADER 

3929 F364 BCG AG BCS BADBSK > IF BAD BOOT, BO IT OVER AGAIN 
3930 F366 20 7E FS JSR DINI iGO INIT. SOFTWARE 

3931 F369 €E6 OF INC BOOT? i SHOW BOOT SUCCESS 

3932 F36B 40 RTS 

3933 F36C i189 BLOAB: CLC 

3934 F36D AB 42 02 LDA BOOTAD 

3935 F370 4&9 06 ADC #4 

3936 F372 85 04 STA RAMLO 

3937 F374 AD 43 02 LDA BOOTAD+1 

3938 F377 4&7 0G ADC #0 

3939 F379 85 OS STA RAMLO+1 iPUT START ADDR OF BOOTLOADER INTO RAM 
3940 F37B 4C 04 00 JMP CRAMLO} 

3941 F37E 4&C GC OO DINI: JMP (DOSINI} 

3942 i 

3943 i 

3944 i 

3945 i 

3946 i; DISPLAY DISK READ ERROR MSG 

3947 i 

3948 F381 A2 OB DSKRDE: LDX #DERRL 

3949 F38G AGO Fi LBY #DERRH 

3950 i 

3951 i 

3952 i 

3953 i; PUT LINE ON SCREEN AT PRESENT CURSOR POSITION 

3954 i 

3955 i X-REG -- LO BYTE. BEGIN ADDR OF LINE 

3956 i Y-REG -- HI BYTE. BEGIN ADDR OF LINE 

3957 i 

3958 F385 8A PUTLIN: TXA 

3959 F386 A2 00 LDX #SEX 

3960 F388 7D 44 63 STA ICBAL, X 

3961 F38SB 98 TYA 

3962 F38BC 9D 45 03 STA ICBAH, X iSET UP ADDR OF BEGIN OF LINE 
3963 FS3SEF AS OF LDA #PUTTXT 

3944 F391 9D 42 03 STA ICCOM, X i “PUT TEXT RECORD" COMMAND 
3965S F394 Ad FF LDA #SFF 

39466 F396 97D 48 03 STA ICBLL, X i SET BUFFER LENGTH 


3967 F399 20 56 E4 JSR crov iPUT LINE ON SCREEN 
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3968 F39C 60 RTS 

3969 i 

3970 i 

3971 j 

3972 ; 

3973 ; GET SECTOR FROM BDISK OG 

3974 i 

3975 F39D AS 4B GETSEC: LDA CASSBT 

3974 F39F FO G3 BEG DISKM iCASSETTE BOOT ? 

3977 FGAL 4C 7A E4 JMP RBLOKYV i YES, GO TO READ BLOCK ROUTINE 
3978 F3A4 A? 52 DISKM: LDA #READ 

3979 F3A6 SD C2 03 STA DCOMND iSET READ SECTOR COMMAND 
3980 FSA? A? O1 LDA #1 

3981 F3AB 8D Gi 63 STA DUNIT iSET DRIVE NO. TO DRIVE © 
3982 FGAE 20 53 £4 JSR DSKINV iGET SECTOR 

3983 FOBi 40 RTS 

3984 i 

3985 i 

3986 i 

3987 i DO CHECK FOR CASSETTE BOOT &% IF SO, DO BOOT 

3988 ; 

3989 FSIB2 AS 08 CSBOOT: LDA WARMST i WARMSTART? 

3990 FUB4 FO GA BEG CSBOT2 i NO 

3991 FS3B6 AS 09 LDA BOOT? iGET BOOT FLAG 

3992 FS3BS 29 62 AND #2 iWAS CASSETTE BOOT SUCCESFULL? 
3993 FaGBA FO 03 BEG NOCSB2 i NO 

3994 FS3BC 26 El FS JSR CINI i YES, INIT CASSETTE SOFTWARE 
3995 FS3BF 406 NOCSB2: RTS 

3996 i 

3997 F3CO AS 4A CSBOT2: LDA CKEY 

3998 F3C2 FO iC BEG NOCSBT i"C" KEY FLAG SET * 

3999 FSC4 A? BC LDA #390 i YES, 

4000 FS3C& 85 SE STA FTYPE i SET LONG IRG TYPE 

4001 F3C8 E66 4B INC CASSBT i SET CASSETTE BOOT FLAG 

4002 FS3SCA 20 7D E4 JSR CSOP IV i OPEN CASSETTE FOR INPUT 
4003 FSCD 20 O01 F3 JSR SECTi iDO BOOT & INIT. 

4004 F3DO0 A? GO LDA #0 

4005 F3D2 85 4B STA CASSBT i; RESET CASSETTE BOOT FLAG 
4006 F3D4 85 44 STA CKEY i CLEAR KEY FLAG 

4007 F3D6 06 OF ASL BOOT? i SHIFT BOOT FLAG (NOW=2 IF SUCCESS} 
4008 F3D8 A5 oc LDA DOSINI 

4009 FS3SDA 85 02 STA CASINI iMOVE INIT ADDRESS FOR CASSETTE 
4010 FS3DC AS OD LDA DOSINI+1 

4011 FSDE 85 03 STA CASINI+1 

4012 F3EO 406 NOCSBT: RTS 

4013 i 

4014 FS3E1 4 C C2 00 CINI: JMP (CASINI} i INIT CASSETTE 

4015 Rete eee eee ee ee ee ee ee ee 
4016 i 

4017 i 

4018 ; SPARE BYTE OR MODULE TOO LONG FLAG 

4019 i 

4020 FSE4 CRNTP7 =# 


4021 i 


ERR LINE ADDR Bi B2 BS B4 MONITOR x#+#2%% MONITP. SRC s#4%% 3/9/79 seeee 4:00 PAGE 90 


4022 #=$14 


4023 0014 06 MONSPR: . BYTE KBDORG-CRNTP7 i “GMONITP TOO LONG 
4024 i 


ERR LINE 


4025 
4026 
4027 
4028 
4029 
4030 
4031 
4032 
4033 
4034 
4035 


ADDR Bi Be BS B4 


007D 
OO9F 


0068 
0066 


MONITOR 


eeee% MONITP. SRC sete 3/9/79 xteee 4:00 


. PAGE 


. TITLE 


DEPENDENT EQUATES 


$7D 
SOF 


SAVADR 
MLTTMP 


‘DISPLAY HANDLER <-- 10-30-78 -- DISPLC’ 


iCLEAR SCREEN ATASCI CODE 
;iPOKEY KEY CODE FOR “i 


PAGE 


91 


ERR LINE 


4036 
4037 
4038 
4039 
4040 


4041 . 


4042 
4043 
4044 
4045 
4046 
4047 
4048 
4049 
4050 
4051 
4052 
4053 
4054 
4055 
4056 
4057 
4058 
4059 
4060 
4061 
4062 
4063 
4064 
4065 
4066 
4067 
4068 
4069 
4070 
4071 
4072 
4073 
4074 
4075 
4076 
4077 
4078 
4079 
4080 
4081 
4082 


ADDR 


E400 
E402 
E404 
E406 
E408 
E40A 
E40C 
E40F 


E410 
E412 
E414 
E416 
E418 
E4iA 
E41c 
E41F 


E420 
E422 
E424 
E426 
E428 
E424 
E42C 
E42F 


E488 


Bi 


BE 


Be BS B4 


FF 


FO 


FS 


F3 


i 


i 


E 


i 


i 


D 


i 
i 
i 
i 
K 


4 


i 


\ 


DISPLAY HANDLER —-- iG-30-78 -- BISPLC 


. PAGE 


#=EDITRV 


SCREEN EDITOR HANDLER ENTRY POINT 


DITOR: . WORD EQPEN-i 
. WORD RETURi-1 i (CLOSE > 
. WORD EGETCH-1 
. WORD E0QUTCH-1 
. WORD RETURi-1 i (STATUS) 
. WORD NOFUNC-1 i (SPECIAL) 
JMP PWRONA 
. BYTE 1) iROM FILLER BYTE 
#=SCRENV 


DISPLAY HANDLER ENTRY POINT 


ISPLA: . WORD DOPEN-1 
. WORD RETURI-1i i (CLOSE } 
. WORD GETCH-1 
. WORD OUTCH-1 
. WORD RETURI-1 i (STATUS) 
. WORD DRAW-1 i; (SPECIAL } 
JMP PWRONA 
. BYTE 0 ;ROM FILLER BYTE 
#=KEYBEDV 


KEYBOARD HANDLER ENTRY POINT 


BDHND: . WORD RETURI-1i 
. WORD RETURiI-~1 i (CLOSE) 
. WORD KGETCH-1 
. WORD NOFUNC-1 i (OUTCH} 
. WORD RETURI-1 i (STATUS) 
. WORD NOFUNC—1 i (SPECIAL >} 
JMP PWRONA 
. BYTE 0 iROM FILLER BYTE 


INTERRUPT VECTOR TABLE ENTRY 
#=VC TABL-INTABS+VKEYBD 
. WORD PIRGS 


i KEYBOARD IRQ INTERRUPT VECTOR 


ERR LINE 


4083 
4084 
4085 
4086 
4087 
4088 
4089 
4090 
4091 
4092 
4093 


ADDR 


FOE4 
FOES 
F3E? 
FSEC 
FOEE 
F3FO 
FOF2 
FOFS 


Bi 


Be BS B4 


DISPLAY HANDLER 


#=KBDORG 


‘ 

PWRONA: LDA 
STA 
LDA 
AND 
STA 
LDA 
STA 
RTS 


-~ 10-30-78 -- DISPLC PAGE 


MEMTOP+1 
#5F CO 
RAMTOP 
#346 
SHFLOK 


i INSURE 4K PAGE BOUNDARY 
i DEFAULT.TO UPPER CASE ALPHA AT PWRON 


i POWER ON COMPLETED 


93 


ERR LINE 


4094 
4095 
4096 
4097 
4098 
4099 
4100 
4101 
4102 
4103 
4104 
4105 
4106 
4107 
4108 
4109 
4110 
4ill 
4112 
4113 
4114 
4119 
4116 
4117 
4118 
4119 
4120 
4121 
4122 
4123 
4124 
4125 
4126 
4127 
4128 
4129 
4130 
4131 
4132 
4133 
4134 
4135 
41236 
4137 
4138 
4139 
4140 
4141 
4142 
4143 
4144 
4145 
4146 
4147 


ADDR 


Bi 


B2 B3 B4 


D2 


02 


02 


02 


FE 
02 


02 
02 


FE 


FE 


DISPLAY HANDLER 


. PAGE 


-- 10-30-78 -- 


BISPLC PAGE 94 


BEGIN DISPLAY HANDLER OPEN PROCESSING 


DOPEN: LDA 
AND 
BNE 
EOPEN: LDA 
AND 
STA 
LDA 
OPNCOM: STA 


CLRTBS: STA 


DOPENS: LDA 


OPNERR: LDA 


DOPENA: STA 


DOPEN1: LDA 


ICAXK22 


TABMAP, Y¥ 


CLRTBS 
#4 
COLRTE, X 
COLORO, X 


DOPENS 
RAMTOP 


TXTMSC+1 
#$40 
TXTMSC 
DINDEX 
ANCONV, X 
DOPENA 
#BADMOD 
DSTAT 
HOLDi 
RAMTOP 
ADRESS+1 
ALOCAT, X 
#40 


iGET AUX 2 BYTE 


i IF MODE ZERO, CLEAR ICAX1Z 
i; CLEAR “CLR INHIBIT" AND “MXD MODE“ BITS 


i INITIALIZE GLOBAL VBLANK RAM 


i TURN OFF DMA NEXT VBLANK 


i CLEAR STATUS 
i; DO IRGEN 
i TEXT INDEX MUST ALWAYS BE 0 


i TURN CURSOR ON AT OPEN 
iCLEAR TAB STOPS 
i INIT TAB STOPS TO EVERY 8 CHARACTERS 


iLOAD COLOR REGISTERS 


iDO FXTMSC=$2C40 (CIF MEMTOP=3000) 


;CONVERT IT TO ANTIC CODE 
iIF ZERO, IT IS ILLEGAL 

i SET ERROR STATUS 

iSET UP AN INDIRECT POINTER 


i ALLOCATE N BLOCKS OF 40 BYTES 


ERR LINE 


B2 BS B4 


2i 


F9 


C2 


F9 


02 


02 


D4 


F9 
FE 


F9 


F? 


02 


02 


DISPLAY HANDLER 


NOTS: 


VBWAIT: 


NOMOD: 


-- 10-30-78 -- 


DBSUB 


DOPENI 
GPRIOR 
#$3F 
OPNTMP +i 


#8 
NOTS 


A 

&é 

A 

#$C0O 
OPNTMP+1 


ADRESS+1 
SAVMSC+i 
VCOUNT 
€37A 
VBWAIT 
DBDEC 
PAGETS, X 
NOMOD 
#SFF 
ADRESS 
ADRESS+1 
ADRESS 
SAVADR 
ADRESS+1 
SAVABR+1 
DBDDEC 
#341 


BOTSCR 


DISPLC PAGE 72 


iCLEAR GTIA MODES 


i TEST IF 320X1 


iGET 2 LOW BITS 


iNOW 2 TOP BITS 


i SUBTRACT 16 MORE FOR PAGE BOUNDARY 

i TEST MODE 11 

i IF MODE = 11 

iPUT GTIA LUM VALUE INTO BACKGROUND REGISTER 


iSTORE NEW PRIORITY 
i SAVE MEMORY SCAN COUNTER ADDRESS 


iWAIT FOR NEXT VBLANK BEFORE MESSING 
iWITH THE DISPLAY LIST 


i START PUTTING DISPLAY LIST RIGHT UNDER RAM 
i TEST IF DISPLAY LIST WILL BE IN TROUBLE 


iOF CROSSING A 256 BYTE PAGE BOUNDARY 
iIF 50, DROP DOWN A PAGE 


i SAVE END OF DISPLAY LIST FOR LATER 


i (DOUBLE BYTE DOUBLE DECREMENT> 
i (ANTIC> WAIT FOR VBLANK AND JMP TO TOP 


i INITIALIZE BOTSCR 


i DISALLOW MIXED MODE IF MODE. GE. 9 


+ TEST MIXED MODE 


ERR LINE 


4202 
4203 
4204 
4205 
4206 
4207 
4208 
4209 
4210 
4211 
4212 
4213 
4214 
4215 
A216 
4217 
4218 
4219 
4220 
4221 
4222 
4223 
4224 
4225 
4226 
4227 
4228 
4229 
4230 
4231 
4232 
4233 
4234 
4235 
4236 
4237 
4238 
4239 
4240 
4241 
4242 
4243 
4244 
4245 
4246 
4247 
4248 
4249 
4250 
4251 
4252 
4253 
4254 
4255 


ADDR . 


F4D3 
F4D5 
F4D7 
FADA 
F4DB 
F4DD 
F4DF 
F4E0 
F4E1 
F4E4 
F4E6 
F4E9 
F4EB 
F4EE 
F4EF 
F4F1 
F4F3 
F4F5 
F4F7 
F4FA 
F4FC 
F4FF 
F500 
F502 
F504 
F506 
F508 
FSOA 
F50C 
F50D 
FSOF 
F512 
F514 
F517 
FSi9 
FSiC 
FS1E 
F521 
F522 
F524 
F526 
F529 
FS2B 
FS2E 
F530 
F532 
F535 
F537 
FS3A 
FS3¢ 
FSOF 
F541 
F544 
F546 


BS B4 


F9 


F 
F> 


F9 


FE 


F 


F 
Fo 
FS 


F? 


F9 


F 


F9 
F9 
F9 
02 


02 


DISPLAY HANDLER 


DOPEN2: 


NOTMXD: 


DOPENS: 


DOPEN4: 


DOPENS: 


LDX 
LDA 
JSR 
DEX 
BPL 
LDY 
DEY 
TYA 
JSR 
LDA 
JSR 
LDA 
JSR 
CLC 
LDA 
ADC 
STA 
LDY 
LDX 
LDA 
JSR 
DEX 
BNE 
LDA 
CMP 
BCC 
LDX 
LDA 
SEC 
SBC 
JSR 
LDA 
JSR 
LDA 
JSR 
LDA 
JSR 
DEX 
BNE 
LDA 
JSR 
LDA 
JSR 
LDA 
ORA 
JSR 


~~ 10-30-78 ~- DISPLC PAGE 96 


#2 +ADD 4 LINES OF TEXT AT BOTTOM OF SCREEN 


BOPEN2 
RAMTOP iRELOAD MSC FOR TEXT 


STORE 
#60 
STORE 
#342 
STORE 


#MXDMDE-NUMDLE ij POINT X AT MIXED MODE TABLE 
OPNTMP 

OPNTMP 

OPNTMP 

NUMDLE, Y iGET NUMBER OF DISPLAY LIST ENTRIES 
HOLD1 i STORE N DLE’S 

STORE 


BOPENG 
DINDEX iDO THE MESSY 320X1 PROBLEM 


#993 iGET REMAINING NUMBER OF DLE’S 
RAMTOP iRELOAD MEMORY SCAN COUNTER 


#$4F i (ANTIC) RELOAD MSC CODE 


HOLD1 i DO REMAINING DLE‘S 


DOPEN4 

SAVMSC+ i iPOLISH OFF DISPLAY LIST 
STORE 

SAVMSC 

STORE 

HOLD1 

#340 

STORE 

#370 i24 BLANK LINES 

STORE 

#$70 

STORE 

ADRESS i SAVE DISPLAY LIST ADDRESS 
SDLSTL 

ADRESS+1 

SDBLSTL+1 


ERR LINE 


4256 
4257 
4258 
4259 
4240 
4261 
4262 
4263 
4264 
4265 
4266 
4267 
4268 
4249 
4270 
4271 
4272 
4273 
4274 
4275 
4276 
4277 
4278 
4279 
4280 
4281 
4282 
4283 
4284 
4285 
4286 
4287 
4288 
4289 
4290 
4291 
4292 
4293 


FB 
96 


BS B4 


F3 


02 


02 
FA 


DISPLAY HANDLER 


DOPEN?: 


DOPEN7: 


i 


GETCH: 


GETPLT: 


SHIFTD: 


SHIFTL: 


i 


i 


OUTCH: 


LDA 
JSR 
LDA 
STA 
LBA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
JSR 
LDA 
JSR 
LDA 
BPL 
PHA 
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#370 
STORE 
ADRESS 
MEMTOP 
ADRESS+1 
MEMTOP+1 
SAVADR 
ADRESS 
SAVADR+1 
ADRESS+i1 
SBLSTL+1 
STORE 
SDBLSTL 
STORE 
DSTAT 
DOPEN? 


EOPEN 


ICAX1iZ 
#320 

DOPEN7 
CLRSCR 
TXTROW 
LMARGN 
TXTCOL 
#322 

SBMCTL 
SBMCTL 
RETUR2 


RANGE 
GETPLT 
INATAC 
INCRSB 
RETURI 
CONYVRT 
(ADRESS), Y¥ 
DMASK 
SHF AMT 
SHIFTi 
A 
SHIFTD 
CHAR 
#0 


ATACHR 
RANGE 


i ADD LAST BLANK LINE ENTRY 
i#POSITION ADRESS=SDLSTL~-1 
i STORE NEW MEMTOP 


i IF ERROR OCURRED ON ALLOCATION, OPEN THE ED 
i SAVE STATUS 

+; OPEN THE EDITOR 

+RESTORE STATUS 

i AND RETURN IT TO CIO 

i TEST CLEAR INHIBIT BIT 


i CLEAR SCREEN 
i AND HOME TEXT CURSOR (AC IS ZERO?) 


iEVERYTHING ELSE IS SET UP 


iSO TURN ON DMACTL 


iGETCH DOES INCRSR, GETPLT DOESN’T 


i CONVERT INTERNAL CODE TO ATASCII 


i CONVERT ROW/COLUMN TO ADRESS 


i SHIFT DATA DOWN TO LOW BITS 


i CUNCONDITIONAL > 


iRESTORE FLAGS ALSO 


ERR LINE 


4310 
4311 
4312 
4313 
4314 
4315 
4316 
4317 
4318 
4319 
4320 
4321 
4322 
4323 
4324 
4325 
4326 
4327 
4328 
4329 
4330 
4331 
4332 
4333 
4334 
4335 
4336 
4337 
4338 
4339 
4340 
4341 
4342 
4343 
4344 
4345 
4346 
4347 
4348 
4349 
4350 
4351 
4392 
4353 
4354 
4399 
4356 
4357 
4358 
4359 
42340 
4341 
4362 
4263 


ADDR 


FSOBD 
FSCO 
FSC2 
FSC4 
FSC7 
FSCA 
FSCD 
FOCF 
FSD1 
FSD4 
FSD7 
FSDA 
FSDD 


FSEO 
FSE3 
FSES 
FOE? 
FOE? 
FSEB 
FSEC 
F SEE 
FOF 1 
FSF2 
FSFS 
FOF4 
FSFS 
FSF6 
FSFS 
FSF9 
FOFA 
FSFC 
FSFF 
F402 
F605 
F408 
F&OA 
F&OC 
F&OD 
F410 
F613 
F615 
F618 
FOLIA 
FG61C 


FOIE 


F420 


F621 
F624 
F426 


B3 B4 


02 


FS 
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i 


DUTCHA: 


OUTCHE: 


OUTCHB: 


i 


OUTPLT: 


CRLOOP: 


OUTCH2: 


SHIFTU: 


SHIFT2: 


i 


RETUR2: 


JSR 
LDA 
CMP 
BNE 
JSR 
JMP 
LDA 
CMP 
BNE 
JSR 
JMP 
JSR 
JSR 
JMP 


LDA 
BNE 
L.DX 
LDA 
STA 
DEX 
BPL 
LDA 
TAY 
ROL 
ROL 
ROL 
ROL 
AND 
TAX 
TYA 
AND 
DRA 
STA 
JSR 
LDA 
LSR 
BCS 
ASL 
JMP 
AND 
STA 
LDA 
EOR 
AND 
DORA 
STA 
RTS 


JSR 
STA 
LDX 


OFFCRS 

ATACHR i TEST FOR CLEAR SCREEN 
#CLRCOD 

OUTCHE 

CLRSCR 

RETUR2 

ATACHR i TEST FOR CARRIAGE RETURN 
#CR 

OUTCHE 

DOCRWS + DBO CR 

RETUR2 

OQUTPLT 

INCRSR 

RETUR2 


SSFLAG ; ##44%4LD00P HERE IF START/STOP FLAG IS NON-O 
OQUTPLT 

#2 

ROWCRS, X i SAVE CURSOR LOCATION FOR DRAW LINE TO DRAW 
OLDROW, X 


CRLOOP 

ATACHR i CONVERT ATASCIICATACHR) TO INTERNAL (CHAR > 
i SAVE ATACHR 

A 

A 

A 

A 

#3 
iX HAS INDEX INTO ATAINT 
i RESTORE ATACHR 

FEOF i STRIP OFF COLUMN ADDRESS 

ATAINT, X iQOR IN NEW COLUMN ADDRESS 

CHAR 

CONVRT 

CHAR 

SHF AMT i SHIFT UP TO PROPER POSITION 

SHIFT2 

A 

SHIFTU 

DMASK 

TMP CHR i SAVE SHIFTED DATA 

DMASK i INVERT MASK 

#SFF 

(ADRESS), Y iMASK OFF OLD DATA 

TMPCHR i; OR IN NEW DATA 

(ADRESS), ¥ 


GETPLT i DO CURSOR ON THE WAY OUT 
OLDCHR 
DINDEX iGRAPHICS HAVE INVISIBLE CURSOR 


ERR LINE 


4364 
4365 
4366 
4367 
4368 


ADDR 


Fé2e8 
F42a 
F62D 
Fear 
F631 
F634 
F636 
F638 
F63a 
F4aD 


BS B4 


02 


FS 


02 


DISPLAY HANDLER 


BNE 
LDX 
BNE 
EOR 
JSR 


RETUR1: LDY 


LBA 
STA 
LDA 


NOFUNC: RTS 


a Tt 


-~ 10-30-78 -- DISPLC PAGE 
RETURI 
CRSINH i TEST CURSOR INHIBIT 
RETUR1 
#$80 i TOGGLE MSB 
OUTCH2 i DISPLAY IT 
DSTAT iRETURN TO CIO WITH STATUS IN Y 
#SUCCES 
DSTAT iSET STATUS= SUCCESSFUL COMPLETION 
ATACHR iPUT ATACHR IN AC FOR RETURN TO CIO 


i (NON-EXISTENT FUNCTION RETURN POINT) 


END OF DISPLAY HANDLER 
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ERR LINE 


4379 
4380 
4381 
4382 
4383 
4384 
4385 
4386 
4387 
4388 
4389 
4390 
4391 
4392 
4393 
4394 
43995 
4396 
4397 
4398 
4399 
4400 


4401 


4402 
4403 
4404 
4405 
4406 
4407 
4408 
4409 
4410 
4411 
4412 
4413 
4414 
4415 
4416 
4417 
4418 
4419 
4420 
4421 
4422 
4423 
4424 
4425 
4426 
4427 
4428 
4429 
4430 
4431 
4432 


ADDR 


F6SE 
F44i 
F644 
F646 
F648 
F64A 
F64C 
F64E 
F450 
F653 
F455 
F458 
F65A 
F45C 
F65F 
F662 
F664 
F666 
F668 
F64B 
F6OE 
F&71 
F674 
F676 
F678 
FO7A 
F&7C 
FO7E 
F480 
F682 
F6B4 
F486 
Fees 
F48B 
F6BE 
F691 
F694 
F696 
F499 
F&9C 
F69E 


F6A1 


F6A4 
F6A7 
FGAA 
FG6éAD 
F4B0 


Bi 


B2 


BS B4 


FC 
FA 


F& 


02 
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PAGE 
EGETCH: JSR SWAP 
JSR ERANGE 
LDA BUFCNT i ANYTHING IN THE BUFFER? 
BNE EGETCS i YES 
LDA ROWCRS iNO, SO SAVE BUFFER START ADDRESS 
STA BUFSTR 
LDA COLCRS 
STA BUFSTR+1 
EGETC1i: JSR KGETCH i; LET‘’S FILL OUR BUFFER 
STY DSTAT SAVE KEYBOARD STATUS 
LDA ATACHR i TEST FOR CR 
CMP #CR 
BEG EGETC2 
JSR BOSS iNO, SO PRINT IT 
JSR SWAP iJSR DOSS DID SWAP SO SWAP BACK 
LDA LOGCOL i BEEP IF NEARING LOGICAL COL 120 
CMP #113 
BNE EGETCS 
JSR BELL 
EGETC6: JMP EGETCI 
EGETC2: JSR OFFCRS iGET BUFFER COUNT 
JSR BOBUFC 
LDA BUFSTR *#RETURN A CHARACTER 
STA ROWCRS 
LDA BUFSTR+1 
STA COLCRS 
EGETC3: LBA BUFCNT 
BEG EGETCS 
EGETC7: DEC BUF CNT i AND RETURN TILL BUFCNT=0 
BEG EGETCS 
LDA DSTAT iIF ERR, LOOP ON EGETC7 UNTIL BUFR IS EMPTIE 
BMI EGETC7 
JSR GETCH 
STA ATACHR 
JMP SWAP i AND RETURN WITHOUT TURNING CURSOR BACK ON 
EGETCS: JSR DOCRWS *+DO REAL CARRIAGE RETURN 
LDA #CR i AND RETURN EOL 
STA ATACHR 
JSR RETUR2 i TURN ON CURSOR THEN SWAP 
STY DSTAT i SAVE KEYBOARD STATUS 
JMP SWAP i AND RETURN THROUGH RETURI 
‘ 
JSRIND: JMP CADRESS > iJSR TO THIS CAUSES JSR INDIRECT 
EQUTCH: STA ATACHR - i SAVE ATASCII VALUE 
JSR SWAP 
JSR ERANGE 
DOSS: JSR OFFCRS i TURN OFF CURSOR 
JSR TSTCTL i TEST FOR CONTROL CHARACTERS (Z=1 IF CTL? 


ERR LINE 


4433 
4434 
4435 
4436 
4437 
4438 
4439 
4440 
4441 
4442 
4443 
4444 
4445 
A44h 
A447 
4449 
4449 
4450 
4451 
4452 
4453 
4454 
4455 
4456 
4457 
4458 
4459 
4440 
4461 
4462 
4463 
4464 
4445 
4466 
4467 
4468 
4469 
4470 
4471 
4472 
4473 
4474 
4475 
4476 
4477 
4478 
4479 
4480 
4481 
4482 
4483 
4484 
4485 
4486 


02 


O02 


02 


FC 


FE 
02 


O02 


DISPLAY HANDLER 


EQUTC6: 


ERETN: 
EQUTCS: 


ee a eT) 


KAGETC2: 


KGETCH: 


KGETC3: 


A4sccol: 


BEG 
ASL 
JSR 
JMP 
LDA 
DORA 
BNE 


LDA 
STA 
LDA 
LSR 
BCS 
LDA 
LDX 
BEG 
LDA 
CMP 
BEG 
STA 
LDX 
STX 
JSR 
TAX 
CPX 
BCC 
LDX 
LDA 
STA 
CMP 
BEG 
CMP 
BNE 
LDA 
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EQUTCS 
ESCFLG *+ESCFLG ONLY WORKS ONCE 
OUTCHE 
SWAP i AND RETURN THROUGH RETURI 
DSPFLG iDO BSPFLG AND ESCFLG 
ESCFLG 
ENUTCS i IF NON-O DISPLAY RATHER THAN EXECUTE IT 
ESCFLG 
iPROCESS CONTROL CHARACTERS 
CNTRLS, X iGET DISPLACEMENT INTO ROUTINE 
ADRESS 
CNTRLS+1,X iGET HIGH BYTE 
ADRESS+1 
JSRIND iDO COMPUTED JSR 
RETUR2 i DO CURSOR 
SWAP iALL DONE SO RETURN THROUGH RETURI 


END SCREEN EDITOR. 


BEGIN KEYBOARD HANDLER 


#$FF 

CH 

ICAX1iZ ; TEST LSB OF AUX1 FOR SPECIAL EDITOR READ MO 

A 

GETOUT 

#BRKABT 

BRKKEY ; TEST BREAK 

K7 ; IF BREAK, PUT BRKABT IN DSTAT AND CR IN ATA 

CH 

#$FF 

KGETCH 

HOLDCH i; SAVE CH FOR SHIFT LOCK PROC 

#$FF i "CLEAR" CH 

CH 

CLICK ;DO KEYBOARD AUDIO FEEDBACK (A IS OK) 
;DO ASCCON 

#$C0 ; TEST FOR CTL & SHIFT TOGETHER 

ASCCO1 

#3 ;BAD CODE 

ATASCI, X 

ATACHR ; DONE 

#380 ;DO NULLS 

KGETC2 

#381 i CHECK ATARI KEY 

KGETC1 

INVFLG 
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4487 F714 49 80 EOR #380 

4488 F718 8D B& O02 STA INVFLG 

4489 F71iB 4C BD F6é JMP KGETC2 i DONT RETURN A VALUE 
4490 F71E Cc? 82 KGETC1i: CMP #$82 i CAPS/LOWER | 

4491 F720 DC 07 BNE Ki 

4492 F722 A? 00 LDA #0 i CLEAR SHFLOK 

4493 F724 8D BE 02 STA SHFLOK 

4494 F727 FO B4 BEG KGETC2 . 

4495 F729 C? 83 Kl: CMP #383 i SHIFT CAPS/LOWER 
4494 F72B DO 07 BNE K2 

4497 F72D A? 40 LDA #$40 

4498 F72F 8D BE O02 STA SHFLOK i SHIFT BIT 

4499 F732 BOC A? BNE KGETC2 

4500 F734 C9 84 Ke: ‘CMP #384 iCNTL CAPS/LOWER 
4501 F73& DO 07 BNE K3 

4502 F738 A? 80 LDA #$80 i;CNTL BIT 

4503 F73A 8D BE 02 STA SHFLOK 

4504 F73D BO 9E BNE KGETC2 

4505 F73F Cc? 835 K3: CMP #$85 i DO EOF 

4506 F741 BO OA BNE KS 

4507 F743 A? && LDA #E0FERR 

4508 F745 85 4C K7: STA DSTAT 

4509 F747 $85 11 STA BRAKEY iRESTORE BREAK 

4510 F749 A? 9B GETOUT: LDA #CR iPUT CR IN ATACHR 
4511 F74B DBO 26 BNE KS i; (UNCONDITIONAL > 
4512 F74D AS 7C Ké: LBA HOLDCH iPROCESS SHIFT LOCKS 
4513 F74F C? 46 CMP #$40 iREGULAR SHIFT AND CONTROL TAKE PRECEDENCE 
4514 F751 86 15 BCS KS i OVER LOCK 

4515 F753 AD FB O02 LDA ATACHR i TEST FOR ALPHA 

4516 F756 C? &i CMP #361 iLOWER CASE A 

4517 F758 960 OE BCC KS iNOT ALPHA IF LT 
4518 F75A C? 7B CMP #%7B ;LOWER CASE Z+1 

4519 F75C BO OA BCS KS iNOT ALPHA IF GE 
4520 F7S5E AD BE 02 LDA SHFLOK i DO SHIFT/CONTROL LOCK 
4521 F761 FG O05 BEG KS i IF NO LOCK, DONT RE-DO IT 
4522 F763 05 7C DRA HOLDCH 

4523 F765 4C FE FG JMP KGETCS i; DO RETRY 

4524 F768 2G 8D FC KS: JSR TSTCTL iDONT INVERT MSB OF CONTROL CHARACTERS 
4525 F76B FO O09 BEG K4 

4526 F76D AD FB O02 LDA ATACHR 

4527 F770 4D B&é O02 EOR INVFLG 

4528 F773 8D FB 02 K8: STA ATACHR 

4529 F776 4C 34 F6 K4: JMP RETURI1 ALL DONE 

4530 i 


4531 ; 


ERR LINE 


ADDR 


Bi 


B2 


BS B4 


02 


02 


FC 


02 


FB 


F7 
FC 


62 


FC 


DISPLAY HANDLER 


; 
ESCAPE: 


CRSRUP : 


UP DNCM: 


COMRET: 


CRSRDN: 


CRSRLF: 


CRSRL1: 
LFRTCM: 


COMRE1: 


CRSRRT: 


CLRSCR: 


CLRSC2: 


CLRSC3: 


HOME: 


. PAGE 


LDA 
STA 
RTS 
DEC 
BPL 
LDX 
DEX 
STX 
JMP 
INC 
LDA 
CMP 
BCC 
LDX 
BEG 


-- 10-30-78 -- 


#$80 
ESCFLG 


ROWCRS 
COMRET 
BOTSCR 


ROWCRS 


(ADRESS), ¥ 


CLRSC2 
ADRESS+1 
ADRESS+1 
RAMTOP 
CLRSC2 
€$FF 
LOGMAP, Y 


#4 
CLRSCS 
COLCR 
LOGCOL 
BUFSTR+1 
#0 
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CONTROL. CHARACTER PROCESSORS 


iSET ESCAPE FLAG 


i WRAPAROUND 


iCOLVERT ROW AND COL TO LOGCOL AND RETURN 


i CUNCONDITIONAL > 


i (IF LMARGN=0, THIS ELIMINATES PROBLEM CASE} 


iCOLVERT ROW AND COL TO LOGCOL AND RETURN 


i (CAUSE BLE) 


i UNCONDITIONAL TO COMMON STORE 


;PUT G IN THE AC 
i (AC IS ZERO) 


i CLEAN UP LOGICAL LINE BIT MAP 
i (Y IS ZERO AFTER CLRSC2 LOOP) 


iPLACE COLCRS AT LEFT EDGE 


ERR LINE 


4584 
4387 
4588 
4589 
4590 
4591 
4392 
4593 
4594 
4595 
4596 
4597 
4598 
4599 
4400 
4601 
4602 
4603 
4404 
4605 
44606 
4607 
44608 
4609 
4610 
4611 
4612 
4613 
4614 
4G1$ 
4616 
4617 
4618 
4619 
4420 
4621 
4622 
4623 
4624 
4429 
4626 
4627 
4628 
4629 
4630 
4631 
4632 
4633 
4634 
4635 
4636 
4637 
4638 
4639 


ADDR 


F7DF 
F7E1 
F7E3 
F7E5 


F7E6 
F7E8 
F7EA 
F7EC 
F7EE 
F7FO 
F7F2 
F7FS 
F7F8 
F7FA 
F7FC 
F7FE 
F800 
F802 
F805 
F807 
FEO0A 
FS8OD 
F810 
F813 
F815 
F817 
FE1L9 
FE1iC 
FSiF 
F821 
F823 
F825 
F628 
FE2A 
FB2D 
FS2F 
Fe32 
Fe34 
F837 
FE3A 
F83D 
FOSF 
F641 
Fe44 
F847 
FS49 
FE4A 
F84D 
FE4E 
F850 
F852 
F854 
F855 


B2 B3 B4 


FC 
F7 


FS 


DISPLAY HANDLER 


BS3: 


BS2: 


BS1: 
TAB: 


TABI: 


TAB2: 


SETTAB: 
CLRTAB: 


INSCHR: 


INSCH4: 


INSCHI1: 


STA 
STA 
STA 
RTS 


LDA 
CMP 
BEQ 
LDA 
CMP 
BNE 
JSR 
JSR 
LDA 
CMP 
BNE 
LDA 
BEQ 
JSR 
LDA 
STA 
JSR 
JMP 
JSR 
LDA 
CMP 
BNE 
JSR 
JSR 
BCC 
BCS 
LDA 
JSR 
BCC 
JMP 
LDA 
JUMP 
LDA 
JMP 
JSR 
JSR 
STA 
LDA 
STA 
JGR 
LDA 
PHA 
JSR 
PLA 
CMP 
BCS 
LDA 
PHA 
JSR 
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ROWCRS 

COLCRS+i 

BUFSTR 

LOGCOL i BACKSPACE 

LMARGN 

BSt 

COLCRS iLEFT EDGE? 

LMARGN 

BS3 i NO 

DELTIM i YES, SEE IF LINE SHOULD BE DELETED 

CRSRLF 

COLCRS 

RMARGN 

BS2 

ROWCRS 

BS2 

CRSRUP 

#$20 iMAKE BACKSPACE DESTRUCTIVE 

ATACHR 

OUTPLT 

DOLCOL i AND RETURN 

CRSRRT iBEGIN SEARCH 

COLCRS i TEST FOR NEW LINE 

LMARGN 

TAB i *NO 

DOCR iDO CARRIAGE RETURN 

LOGGET iCHECK IF END OF LOGICAL LINE 

TABI iNOQ, CONTINUE 

TAB2 i CUNCONDITIONAL > 

LOGCOL i CHECK FOR TAB STOP 

BITGET 

TAB iNO, SO KEEP LOOKING 

DOLCOL iCOLVERT ROW AND COL TO LOGCOL AND RETURN 

LOGCOL 

BITSET iSET BIT IN MAP AND RETURN 

LOGCOL 

BITCLR PCEEAR OS)  Sos0 

PHACRS 

GETPLT iGET CHARACTER UNDER CURSOR 

INSDAT 

#0 

SCRFLG 

OUTCH2 i STORE DATA 

LOGCOL i SAVE LOGCOL: IF AFTER INCRSA LOGCOL IS 
i< THAN IT IS NOW. END LOOP 

INCRSA i SPECIAL INCRSR ENTRY POINT 

LOGCOL 

INSCHS i QUIT 

INSDAT iKEEP GOING 

GETPLT 


ERR LINE 


4640 
4641 
4642 
4643 
4444 
4645 
4646 
4647 
4448 
4649 
4450 
4451 
4652 
4653 
4654 
4655 
4456 
4657 
46458 
4459 
4640 
4661 
4662 
44663 
4664 
4665 
4666 
4467 
4648 
44649 
4470 
4671 
4672 
4673 
4674 
4675 
4676 
4477 
4478 
4479 
4680 
4681 
4682 
4683 
4684 
44685 
4686 
4687 
4688 
4689 
4690 
4691 
4492 
4693 


ADDR 


F858 
FeaSA 
Fase 
FSSE 
FE41 
F864 
F846 
F868 
FE6A 


F86D 
F870 
F873 
F875 
F877 
Fe/9 
F87B 
F87D 
FE7E 
FB81 
F882 
FeS84 
F886 
FSss 
FS8B 
Fesp 
F890 
F892 
F894 
F896 
F898 
F899 
F89B 
FE9E 
FSA1 
FSA4 
FEAS 
FSA 
FEAA 
FRAC 
FEAF 
FSB1 
Fees 
FeB4 
FSB4 
F8Bs 
FSBA 
FSBC 
FSBE 
FBCO 
F&C2 
Fec4 
FSC6 
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7D STA INSDAT 
PLA 
44 Fe JMP INSCH4 
A8 FC INSCH3: JSR PLACRS 
BB 02 INSCH4: DEC SCRFLG 
04 BMI INSCHS ; IF SCROLL OCCURRED 
54 DEC ROWCRS ;MOVE CURSOR UP 
F7 BNE INSCH& ; (UNCOND) CONTINUE UNTIL SCRFLG IS MINUS 
DD FB INSCHS: WMP DOLCOL ;COLVERT ROW AND COL TO LOGCOL AND RETURN 
9D FC DELCHR: JSR PHACRS 
47 FF DELCH1: JSR CONVRT iGET DATA TO THE RIGHT OF THE CURSOR 
64 LDA ADRESS 
48 STA SAVADR i SAVE ADRESS TO KNOW WHERE TO PUT DATA 
45 LDA ADRESS+1 
4? STA SAVADR+1 
43 LDA LOGCOL 
PHA 
D4 F9 JSR INCRSB ;PUT CURSOR OVER NEXT CHARACTER 
PLA 
43 CMP LOGCOL i TEST NEW LOGCOL AGAINST OLD LOGCOL 
10 BCS DELCH2 i IF OLD. GE.NEW THEN QUIT 
54 LDA ROWCRS i; IS ROW OFF SCREEN? 
BF 02 CMP BOTSCR 
oF BCS DELCH2 ;YES, SO QUIT 
AZ F5 JSR GETPLT ;GET DATA UNDER CURSOR 
ere, LDY #0 
48 STA (SAVADR},Y i PUT IT IN PREVIOUS POSITION 
DA BEG DELCH1 ;AND LOOP (UNCONDITIONAL) 
OG DELCH2: LDY #0 
TYA 
68 STA (SAVADR), Y iCLEAR THE LAST POSITION 
68 FC JSR DELTIA iTRY TO DELETE A LINE ‘ 
Ag FC JSR PLACRS 
DD FB JMP DOLCOL ;AND RETURN 
INSLIN: SEC NORMAL INSLIN PUTS “1" INTO BIT MAP 
7B FB INSLIA: JSR EXTEND ;ENTRY POINT FOR C=O 
52 LDA LMARGN ;DO CARRIAGE RETURN (NO LF) 
55 STA COLCRS 
47 F9 JSR CONVRT ;GET ADDRESS 
a4 LDA ADRESS ;SET UP TO=40+FROM (FROM = CURSOR) 
68 STA FRMADR 
CLC 
28 ADC #40 
46 STA TOADR 
45 LDA ADRESS+1 
49 STA FRMADR+1 
ere) ADC #0 
&7 STA TOADR+1 
54 LDX ROWCRS ;SET UP LOOP COUNTER 
17 CPX #23 
os BEG INSLI2 
4— FB INSLI1: JSR MOVL IN 


ERR LINE 


4494 
4695 
4696 
4697 
4698 
4699 
4700 
4701 
4702 
4703 
4704 
4705 
4706 
4707 
4708 
4709 
4710 
4711 
4712 
4713 
4714 
4715 
4716 
4717 
4718 
4719 
4720 
4721 
4722 
4723 
4724 
4725 
4726 
4727 
4728 
4729 
4730 


ADDR 


FaC9 
FECA 
FCC 
F&CE 
FeD1 
FaD4 
FED7 
F8D9 
F8DB 
F8DD 
FSDE 
FSDF 
FeE2 
FRES 
FeE4 
FEES 
FSE7 
Fees 
FBEB 
FEC 
FEE 
Faro 
Far3 
FeF5 
FSFe 
FEFA 
FEFC 
FSFF 
F902 


F905 
F907 
F9OA 
FOC 
FOF 
F910 
F912 


B3 B4 


FB 


FB 


02 


DISPLAY HANDLER 


INSLIe2: 


DELLIN: 
DELLIA: 


DELLIB: 
DELLII: 


DELLI2: 


i I8 IT 


BELL: 
BELLI: 


~- 10-30-78 -- DISPLC PAGE 106 


INX 

CPX #23 

BNE INSLI1 

JSR CLRLIN iCLEAR CURRENT LINE 

JMP DOLCOL iCOLVERT ROW AND COL TO LOGCOL AND RETURN 
JSR DOLCOL iGET BEGINNING OF LOG LINE (HOLD1) 
LDY HOLD1 i SQUEEZE BIT MAP 

STY ROWCRS iPUT CURSOR THERE 

LDY ROWCRS 

TYA 

SEC 

JSR LO2GET iGET NEXT BIT 

PHP 

TYA 

CLC 

ADC #120 

PLP 

JSR BITPUT iWRITE IT OVER PRESENT BIT 

INY R 
CPY #24 

BNE DELLI1 i LOOP 

LDA LOGMAP +2 i SET LSB 

ORA #1 

STA LOGMAP+2 

LDA LMARGN iDELETE LINE OF DATA USING PART OF SCROLL 
STA COLCRS iCR NO LF 

JSR CONVRT 

JSR SCROL1 

JSR LOGGET i TEST NEXT LINE FOR CONTINUATION 

A NEW LOG LINE? 

BCC DELLIB iNO SO DELETE ANOTHER 

JMP DOLCOL i YES SO DOLCOL AND RETURN 

LDY #320 

JSR CLICK 

DEY 

BPL BELLi 

RTS 


ERR LINE 


4731 
4732 
4733 
4734 
4735 
4736 
4737 
4738 
4739 
4740 
4741 
4742 
4743 
4744 
4745 
4746 
4747 
4748 
4749 
4750 
47351 
4752 
47533 
4754 
4735 
4736 
4737 
4758 
4759 
4760 
4761 
4762 
47643 
4764 
4765 
4766 
4767 
4768 
4769 
4770 
4771 
4772 
4773 
4774 
4775 
4776 
4777 
4778 
4779 
4780 
4781 
4782 
4783 
4784 


ADDR 81 B2 BS B4 


F913 
F915 


F917 
F919 
F91B 
F91D 


FFLF 
F921 
F924 
F926 
F928 
F9QA 
F92B 
F9QE 
F930 
F932 
F934 
F936 
F938 
F93A 
F93C 
F93E 
F940 
F942 
F944 
F946 


F947 
Fo49 
FO4A 
Fo4C 
F94D 
FO4F 
F950 
F953 
F955 


02 


FC 


DISPLAY HANDLER 


. PAGE 


i ROUTINES 
i 


DBDDEC: LDA 
BNE 


i 


-- 10-30-78 -- 


#2 
DBSUB 


DISPLC PAGE 107 


DOUBLE BYTE DECREMENT OF INDIRECT POINTER 
INCLUDING DB SUBTRACT AND DB DOUBLE DECREMENT 


i CUNCONDITIONAL > 


i STORE DATA INDIRECT AND DECREMENT POINTER 
i (PLACED HERE TO SAVE JMP DBDEC AFTER STORE} 


STORE: LDY 
BMI 
LDY 
STOREL: STA 
i JMP 


DBDEC: LDA 
DBSUB: STA 


DBSUB1: LDA 


STRERR: LDA 


STROK: RTS 


CONVERT ROW/COLUMN CURSOR 


CONVRT: LDA 
PHA 
LDA 
PHA 
LDA 
PHA 
JSR 
LDA 
STA 


DSTAT 


(ADRESS}, Y 


DBDEC 


#1 
SUBTMP 
BSTAT 
STROK 
ADRESS 


SUBTMP 
ADRESS 
DBSUB1 
ADRESS+1 
APPMHI+1 
ADRESS+1 
STROK 
STRERR 
APPMHI 
ADRESS 
STROK 
#SCRMEM 
DSTAT 


ROWCRS 
COLCRS 
COLCRS+1 
PUTMSC 


ROWCRS 
MLTTMP 


*#RETURN ON ERROR 


DECREMENT AND RETURN 


;RETURN ON ERROR 


iMAKE SURE NOTHING EVER OVERWRITES APPMHI 


i OK 
i ERROR 


i SHOW MEM TOO SMALL FOR SCREEN ERROR 


INTO REAL ADDRESS (FROM SAVMSC ON UP) 


i SAVE CURSOR 


iPUT 1O#ROWCRS INTO MLTTMP 


ERR LINE 


4785 
4786 
4787 
4788 
4789 
4790 


4791 


4792 
4793 
4794 
4795 
4796 
4797 
4798 
4799 
4800 
4801 
4802 
4803 
4804 
4805 
4806 
4807 
4808 
4809 
4810 
4Bii 
4812 
4813 
4814 
4815 
4B16 
4817 
4918 
4819 
4820 
4821 
4822 
4823 
4824 
4825 
4826 
4827 
4828 
4829 
4830 
4831 
4832 
4833 
4834 
4835 
4836 
4837 
4838 


ADDR 


F957 
F959 
FO5B 
F9SD 
FOSE 
F940 
F962 
F964 
F967 
F948 
FO6A 
F96B 
F94D 
FO4E 
F970 
F972 
F974 
F977 
F979 
F97B 
FO7E 
FO7F 
FoB1 
F983 
F985 
F988 
F9SB 
F98D 
FOSF 
F990 
F992 
F993 
F995 
F996 
F999 
F99C 
F99D 
F99E 
FIAO 
F9A2 
FIA4 
FOAG 
FIAT 
FOAA 
FOAB 
FFAC 
FOAE 
FOB1 
FOB 
FOR4 
FOB 
F9BS 
FOBA 
FOBC 


BS B4 


02 


02 


FE 


Fo 


o2 
F 


DISPLAY HANDLER 


CONVR1: 


CONVR2: 


CONVRG: 


CONVR4: 


CONVRS: 
CONVRG: 


LBA 
STA 
LBA 
ASL 
ROL 
STA 
LDY 
STY 
ASL 
ROL 
ASL 
ROL 
CLC 
ADC 
STA 
LDA 
ADC 
STA 
LDX 
LDY 
DEY 
BMI 
ASL 
ROL 
JMP 
LDY 
LDA 
LDX 
DEY 
BMI 
DEX 
LSR 
ROR 
ROR 
JMP 
INY 
CLC 
ADC 
STA 
BCC 
INC 
SEC 
ROR 
CLC 
DEX 
BPL 
LDX 
LDA 
CLC 
ADC 
STA 
STA 
LDA 
ADC 


-- 10-30-78 -- 


#0 
MLTTMP+1 
MLT TMP 

A 
MLTTMP+ i 
HOLDi 
MLTTMP +1 
HOLDB2 

& 
MLTTMP +1 
A 
MLTTMP+ i 


HOLD? 
MLTTMP 
MLTTMP+1 
HOLD2 
MLTTMP+ 1 
DINDEX 
DHLINE, X 


CONVR2 
MLTTMP 
MLTTMP+1i 
CONVRI 
DIV2TB, xX 
COLCRS 
#7 


CONVR4 


COLCRS+1 
A 
TMPLBT 
CONYVRS 


MLTTMP 
MLTTMP 
CONVRS 
MLTTMP+1 


TMPLBT 


CONVRG 
TMPLBT 
MLTTMP 


ADRESS 
ADRESS 
OLDADR 
MLTTMP+ i 
ADRESS+1 
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i QUICK x8 


i (SAVE 2X VALUE) 


> thet 
e 


i ADD IN 2X 


iNOW SHIFT MLTTMP LEFT DHLINE TIMES TO FINIS 
iMULTIPLY 
iLOOP N TIMES 


*#NOW DIVIDE HCRSR TO ACCOUNT FOR PARTIAL BYT 


i*# TRICKY * 


i SAVE LOW BITS FOR MASK 
iSO Y IS ZERO UPON RETURN FROM THIS ROUTINE 


iADD SHIFTED COLCRS TO MLTTMP 


i% TRICKY # 
iSLIDE A “i" UP AGAINST LOW BITS (CONTINUE T 


i AND FINISH SHIFT SO LOW BITS ARE 
iRIGHT JUSTIFIED. 

i TMPLBT I5 NOW THE INDEX INTO DMASKTB 
i PREPARE FOR RETURN 


i#REMEMBER THIS ADDRESS FOR CURSOR 


ERR LINE 


4839 
4840 
4841 
4B42 
4843 
4844 
4845 
4846 
4847 
4848 
4B49 
4850 
4951 
4952 
4953 
4954 
4855 
4856 
4857 
4858 
4959 
4860 
4861 
4862 
4863 
4864 
4865 
4864 
4867 
4968 
4869 
4870 
4871 
4872 
4873 
4874 
4875 
4876 
4877 
4878 
4879 
4880 
4981 
4982 
4883 
4884 
4e85 


4886 — 


4887 
4888 
4889 
4890 
4891 
4892 


B2 BS B4 


FE 
02 


FE 


FB 
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i 
i 
i 
i 
I 


INCRSR: 
INCRSC: 
INCRSA: 


INCRS2: 


INCRS3: 
INC2A: 


DOCR1: 


DOCRIB: 


NCRSB: 


STA 
STA 
LDA 
STA 
STA 
PLA 
STA 
PLA 
STA 
PLA 
STA 
RTS 


INCREMENT 


ADRESS+1 
OLDADR+1 
DMASKT. X 
DMASK 
SHF AMT 


COLCRS+1 
COLCRS 


ROWCRS 


CURSOR AND DETECT BOTH END OF LINE AND END OF SCREEN 


#0 
INCRSC 
#$9R 
INSDAT 
LOGCOL 
COLCRS 
INCRS2 
COLCRS+1 
COLCRS 
DINDEX 
COLUMN, X 


#8 
DOCRi 
COLCRS+1 
INCRS3 
DINDEX 
DOCR 
LOGCOL 
#81 
DOCRiB 
INSDAT 
DOCR 
DOCRWS 
INCRS1 
DOCR 
ROWCRS 


#126 

BITGET 
DOCRIA 
INSDAT 


iNON-EXTEND ENTRY POINT 
i SPECIAL CASE ELIMINATOR 
i (INSCHR ENTRY POINT) 
iDO HIGH BYTE 

i TEST END OF LINE 


i TEST TABLED VALUE FOR ALL SCREEN MODES 
iDO CR IF EQUAL 

iMODE O°? 

i IF NOT, JUST RETURN 

i TEST AGAINST RMARGN 

i; EQUAL IS OK 

i IF GREATER THAN, DO CR 


i CHECK MODE 

iNOT 320X1 SO DO IT 

i TEST MSD 

i ONLY AT 64 SO DON’T DO IT 

iDON‘T MESS WITH LOGMAP IF NO MODE ZERO 


i TEST LINE OVERRUN 

i IF LESS THAN 81 IT IS DEFINITELY NOT LINE 3 
ij; ONLY DO LOG LINE OVERFLOW IF INSDAT <>0 
+LOG LINE OVERFLOW IS SPECIAL CASE 

i RETURN 

iGET IT OVER WITH 

i TEST LOGICAL LINE BIT MAP 


i DON’T EXTEND IF OVERRUN IS INTO MIDDLE OF L 
i DON’T EXTEND IF INSDAT IS ZERO 


ERR LINE 


4893 
4894 
4895 
4896 
4897 
4898 
4899 
4900 
4901 
4902 
4903 
4904 
4905 
4906 
4907 
4908 
4909 
4910 
AFi1 
4912 
4913 
4914 
4915 
4916 
4917 
4918 
A919 
4920 
4921 
4922 
4923 
4924 
4925 
4926 
4927 
4928 
4929 
4930 
4931 
4932 
4933 
4934 
4935 
4936 
4937 
4938 
4939 
4940 
A941 
4942 
4943 
4AG44 
4945 
4946 


ADDR 


FA23 
FA25 
FA2Z6 
FA2? 
FA2C 
FA2E 
FASO 
FAS2 
FAS4 
FA37 
FAS9 
FASB 
FASD 
FASF 
FA41 
FA&3 
FA4S 
FA47 
FA48 
FA4A 
FA4D 
FA4SF 
FAS1 
FAS4 
FASS 
FAS7 
FAS? 


FASB 
FASD 
FASE 
FASO 
FAGI 
FAG4 
FAG7 
FA&? 
FAG&C 
FAGF 
FA7Q 
FA72 
FA7S 
FA77 


FA7A 
FA7B 
FA7D 
FA7F 
FA81 
FA83 
FAB8S 
FAS87 


BS B4 


FS 
FB 


FC 


FE 


FB 


02 


02 


02 


O02 


FB 


DISPLAY HANDLER 


DOCRIA: 
NOSCRL: 


DOCRWS: 


NOSCR1: 
DOCR: 


DOCR2: 


DOCR2A: 
DOCR2B: 


DOCR4B: 


INCRSL: 


? 


; 


BEG 
CLC 
JSR 
JMP 
LDA 
BEG 
LDA 
STA 
JSR 
LDA 
STA 
INC 
LDX 
LDY 
BIT 
BPL 
LDY 
TYA 
BNE 


BPL 
LDA 
STA 
JMP 


110 
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DOCRiA i CINSCHR SPECIAL CASE> 
i; INSERT "“O" INTO BIT MAP 
INSLIA 
DOLCOL i CONVERT ROW AND COL TO LOGCOL AND RETURN 
#0 ;DOCR WITHOUT SCROLL 
NOSCRi i (UNCONDITIONAL } 
#398 ;DOCR WITH SCROLLING (NORMAL MODE> 
INSDAT = 
COLCR ;iPLACE COLCRS AT LEFT EDGE 
#0 
COLCRS+1 
ROWCRS 
DINDEX 
#24 i; SET UP SCROLL LOOP COUNTER 
SWPFLG 
DOCR2A i BRANCH IF NORMAL 
#4 
DOCR2B i CUNCONDITIONAL > 
NOROWS, X ;GET NO OF ROWS 
ROWCRS 
INCRS1 
HOLDS 
i DON’T SCROLL IF MODE <> 0 
INCRS1 
INSDAT iOR IF INSDAT = 0 
INCRS1 
INSDAT IF INSDAT <> $9B THEN ROLL IN A O 
#598 i TO EXTEND BOTTOM LOGICAL LINE 
BDOCR4B 
SCROLL iLOOP BACK TO HERE IF >i SCROLLS 
SCRFLG 
BUFSTR i;ROWS MOVE UP SO BUFSTR SHOULD TOO 
HOLDS 
LOGMAP 
iFOR PARTIAL LINES, ROLL IN A "1" 
DOCRAB i AGAIN IF PARTIAL LOGICAL LINE 
HOLDS ;PLACE CURSOR AT NEW LINE NEAR THE BOTTOM 
ROWCRS 
DOLCOL iCOLVERT ROW AND COL TO LOGCOL AND RETURN 


i SUBEND: SUBTRACT ENDPT FROM ROWAC OR COLAC. (X=0 OR 2) 


SUBEND: 


SEC 
LDA 
SBC 
STA 
LDA 
SBC 
STA 
RTS 


ROWAC, X 
ENDPT 
ROWAC, X 
ROWAC+1, X 
ENDPT+1 
ROWAC+1, X 
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4947 ; 

4948 i 

4949 i RANGE: DO CURSOR RANGE TEST. IF ERROR, POP STACK TWICE AND JMP RETURN 
4950 i (ERANGE IS EDITOR ENTRY POINT AND TEST IF EDITOR IS OPEN. 
4951 i IF IT ISNT IT OPENS THE EDITOR AND CONTINUES) 

4952 i 

4953 FASS AD BF 02 ERANGE: LDA BOTSCR iIF BOTSCR=4 

4954 FABB C? G4 CMP #4 

49355 FASD FC 07 BEG RANGE i THEN IT IS IN MIXED MODE AND OK 

495& FASF AS S7 LDA DINDEX i IF MODE = 0 

4957 FA91 FG 03 BEG RANGE i THEN IT IS IN EDITOR MODE AND OK 

4958 FA93 20 FC F3 JSR EOPEN i IF NOT, OPEN EDITOR 

4959 FA96 A? 27 RANGE: LDA #39 ; ##HHH% RANGE CHECK RMARGN #24422 SET UP AC 
4960 FA9S CS 53 CMP RMARGN ; ##H#H#H RANGE CHECK RMARGN ####% COMPARE 
49461 FAGA BO G2 BcS RANGES ; ##H#H#4 RANGE CHECK RMARGN #+24% BRANCH GE 
4962 FA9C 85 53 STA RMARGN 7 #HHHH RANGE CHECK RMARGN ##8##% BAD SO STORE 
4963 FASE A&A& 57 RANGES: LDX DINDEX 

4964 FAAQ BD 99 FE LDA NOROWS, X i CHECK ROWS 

4965 FAAS -cS 54 CMP ROWCRS 

4966 FAAS 976 2A BCC RNGERR i (ERROR IF TABLE. GE. ROWCRS) 

4967 FAA7 FO 28 BEG RNGERR 

4968 FAAQ EC OS CPX #8 i CHECK FOR 320X1 

4969 FAAB DG OA BNE RANGE I i SPECIAL CASE IT 

4970 FAAD AS 56 LBA COLCRS+1 

4971 FAAF FO i3 BEG RNGOK i IF HIGH BYTE IS OG, COL IS OK 

4972 FABI C9 O1 CMP #1 

4973 FABS DG iC BNE RNGERR i IF >1, BAD 

4974 FABS FO 64 BEQ RANGES i IF 1, GO CHECK LOW BYTE 

4975 FAB7 A5 56 RANGEL: LDA COLCRS+1 i FOR OTHERS, NON-ZERO HIGH BYTE IS BAD 
4974 FAB9 DBO 16 BNE RNGERR 

4977 FABB BD 8D FE RANGE2: LDA COLUMN, X i CHECK LOW BYTE 

4978 FABE C5 $5 CMP COLCRS 

4979 FACO FC OF Bcc RNGERR 

4980 FAC2 FG OD BEG RNGERR 

4981 FAC4 A9 O1 RNGOK: LDA #SUCCES iSET STATUS OK 

4982 FAC& 85 4¢ STA DSTAT 

4983 FACS A? 8O LDA #BRKABT i PREPARE BREAK ABORT STATUS 

4984 FACA Aé6 i1 LDX BRKAKEY i CHECK BREAK KEY FLAG 

4985 FACC 85 il STA BRKKEY i ‘CLEAR’ BREAK 

4986 FACE FO 06 BEG RNGER2 i IF BREAK, QUIT IMMEDIATELY AND RETURN TO CI 
4987 FADBQ 6&6 RTS 

4988 FADL 20 D& F7 RNGERR: JSR HOME iON RANGE ERROR, BRING CURSOR BACK 

4989 FAD4 AS 8B LDA #CRSROR i SHOW CURSOR OVERRANGE ERROR 

4990 FADS 85 4¢C RNGER2: STA DSTAT 

4991 FADS 648 RNGERL: PLA iRESTORE STACK (THIS ROUTINE IS ALWAYS 1 LEV 
4992 FADS 6&8 PLA i AWAY FROM RETURN TO CIO) 

4993 FADA AS 7B LDA SWPFLG i IF SWAPPED, SWAP BACK 

4994 FADC 10 03 BPL RETURS 

4995 FADE 20 BY FC JSR SWAPA +AND DONT DO RETURI 

4996 FAE1 4C 34 F6& RETURS: JMP RETURI i RETURN TO CIO 

4997 i 

4998 i 

4999 i 

300G i 


OFFCRS: RESTORE OLD DATA UNDER CURSOR SO IT CAN BE MOVED 


ERR LINE 


ADDR 


FAE4 
FAES 
FAES 
FAEA 


FAEB 
FAEC 
FAEE 
FAEF 
FAF2 
FAF4 
FAFS 
FAFS 
FAF7 
FAFS 
FAF9 


FAFA 
FAFD 
FBOO 
FBOS 


FBO4 


FBO6 
FBO? 
FBOC 
FBOE 
FBil 


FBi2 
FB1S 
FB17 
FB19? 
FBIC 
FBIF 


FB20 
FB22 


B2 BS B4 


07 


B9 
6E 


FE 


02 


02 


FA 
02 


02 


FA 


02 


02 
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OFFCRS: LDY #0 
LDA OLDCHR 
STA (OLBADR}, Y 
RTS 
i 
i BITMAP ROUTINES: 
i BITCON: PUT MASK IN BITMSK AND INDEX IN X 
i BITPUT: PUT CARRY INTO BITMAP 
i BITROL: ROL CARRY INTO BOTTOM OF BITMAP (SCROLL) 
i BITSET: SET PROPER BIT 
i BITCLR: CLEAR PROPER BIT 
i BITGET: RETURN CARRY SET IF BIT IS THERE 
i LOGGET: DO BITGET FOR LOGMAP INSTEAD OF TABMAP 
BITCON: PHA 
AND #7 
TAX iGET MASK 
LDA MASKTB, X 
STA BITMSK 
PLA iPROCESS INDEX 
LSR A 
LSR 4 
LSR &é 
TAX 
RTS 
BITROL: ROL LOGMAP+2 
ROL LOGMAP+1 
ROL LOGMAP 
RTS 
BITPUT: BCC BITCLR i AND RETURN 
i OTHERWISE FALL THROUGH TO BITSET AND RETURN 
BITSET: JSR BITCON 
LDA TABMAP, X 
ORA BITMSK 
STA TABMAP, X 
RTS 
BITCLR: JSR BITCON 
LDA BITMSK 
EOR #2FF 
AND TABMAP, X 
STA TABMAP., X 
RTS 
LOGGET: LDA ROWCRS 
LOIGET: CLC 


1i2 


ERR LINE 


$055 
3056 
9057 
3058 
S059 
3060 
3061 
9062 
9043 
9064 
3045 
9066 
5067 
9048 
S069 
5070 
9071 
5072 
5073 
9074 
5075 
5074 
5077 
9078 
3079 
5080 
S081 
3082 
S083 
3084 
S085 
5086 
9087 
9088. 
S089 
3090 
SOF 1 
S092 
5093 
9094 
S095 
S096 
5097 
3098 
5099 
5100 
9101 
9102 
9103 
3104 
9105 
9106 
9107 
9108 


ADDR 


FB23 
FB25 
FB28 
FB29 
FB2C 
FB@E 
FBS3O 
FBS1 


FB32 
FBSS 
FB37 
FB39 
FBSB 
FB3C 
FESD 
FBSE 
FBOF 
FB41 
FB42 
FB45 
FB47 
FB4A 
FR4D 


FB4E 
FB50 
FB52 
FB54 
FB56 
FB58 
FBSA 
FB5C 
FBSE 
FB6O 
FBé2 
FB&4 
FB45 


FB&7 


FB49? 
FB4B 
FB4&D 
FBOF 


B2 B32 B4 


FA 


02 


02 


02 


FE 
02 
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LO2GET: ADC #120 
BITGET: JSR BITCON 

ae 

LDA - TABMAP, X 

AND BITMSK 

BEG BITGE1 

SEC 

RTS 


BITGE1L: 


eee we 


INATAC: 


~ 


INATAL: 


MOVLIN: 


ee Pe Ty 


MOVLI1: 


INATAC: INTERNAL (CHAR? TO ATASCIICATACHR) CONVERSION 


LDA CHAR 

LDY BINDEX i IF GRAPHICS MODES 
CPY #3 

BCS INATAI i THEN DON’T CHANGE CHAR 
ROL 4 

ROL A 

ROL A 

ROL A 

AND #3 

TAX 

LDA CHAR 

AND #S9F 

DRA INTATA, X 

STA ATACHR 

RTS 


MOVLIN: MOVE 40 BYTES AT FRMADR TO TOADR SAVING OLD TOADR 


DATA IN THE LINBUF. THEN MAKE NEXT FRMADR 
BE AT LINBUF FOR NEXT TRANSFER & TOADR=TOADR+40 


LDA #LINBUF/254 i SET UP ADRESS=LINBUF=$247 
STA ABRESS+1i 

LDA #LINBUPF. AND. $FF 

STA ADRESS 

LDY #39 

LDA (TOADR>, Y i SAVE TO DATA 

STA TMPCHR 

LDA (FRMADR?,Y i STORE DATA 

STA (TOADR?, Y 

LDA TMPCHR 

STA (ADRESS), ¥ 

DEY 

BPL MOVLI1 

LDA ADRESS+1 i SET UP FRMADR=LAST LINE 
STA FRMADR+1 

LDA ADRESS 

STA FRMADR 

CLC iADD 40 TO TOADR 


113 


ERR LINE 


3109 
3110 
Siil 
S112 
$113 
$114 
$115 
9116 
$117 
$118 
3119 
5120 
9121 
S122 
$123 
$124 
3125 
9126 
9127 
3128 
5129 
9130 
S1i3i 
9132 
$133 
3134 
$135 
3136 
9137 
3138 
9139 
3140 
Si4i 
3142 
3143 
3144 
9145 
S146 
3147 
5148 
9149 
5150 
5151 
3152 
3153 
5154 
9155 
9156 
3157 
3158 
5159 
$140 
3141 
3142 


ADDR 


FB70O 
FB72 
FB74 
FB76 
FB78 
FB7A 


FB7B 
FB7C 
FB7E 
FB7F 
FBa2 
FEBS 
FBE4 
FBSS 
FB87 
FBaS 
FBSB 
FBAC 
FESE 
FB9O 
FB92 
FB94 
FB95 
FB97 
FB9S 


FB9B 
FB9OD 
FBOF 
FBA2 
FRBA4 
FBAG 
FBA8 
FBA9? 
FBAB 


FBAC 
FEAF 
FEBI 
FBBS 


B2 Ba B4 


17 


22 


FB 


FB 


FB 


F 


FA 


DISPLAY HANDLER -- 1410-30-78 -- BISPLC PAGE 


LDA 
ADC 
STA 
BCC 
INC 
MOVLI2: RTS 


i 
i 
. 
i 
i 


EXTEND: PHP 
LDY 
EXTENI: TYA 
JSR 
PHP 
TYA 
CLC 
ADC 
PLP 
JSR 
EXTENS: DEY 
BMI 
CPY 
BCS 
EXTEN4: LDA 
CLC 
ADC 
PLP 
JMP 


CLRLIN: CLEAR 


a ed 


CLRLIN: LDA 
STA 
JSR 
LDY 
LDA 
CLRLIL: STA 
DEY 
BPL 
RTS 


won ee os 


CROLL: JSR 
LDA 
STA 
LDA 


TOADR 
#40 
TOADR 
MOVLI2 
TOADR+1 


EXTEND: EXTEND BIT MAP FROM ROWCRS (EXTEND LOGICAL LINE 


i SAVE CARRY 
#23 


LOIGET 


#121 

BITPUT 
EXTEN4 
ROWCRS 
EXTEN? 
ROWCRS 
#126 


BITPUT *#STORE NEW LINE ’S BIT AND RETURN 


LINE CURSOR IS ON 


LMARGN 


(ADRESS?, Y 


CLRLIG 


SCROLL: SCROLL SCREEN 


BITROL #ROLL IN CARRY 

SAVMSC i SET UP WORKING REGISTERS 
ADRESS 

SAVMSC+1 


114 


ERR LINE) 


31463 
5164 
3165 


ADDR 


FBBS 
FBB?7 
FBB9 
FEBB 
FBBD 
FBBE 
FBCO 
FBC2 
FBC4 
FBC6 
FBCS 
FBCA 
FBCC 
FBCE 
FBDO 
FBD2 
FBD4 
FBD& 
FBD8 
FBDA 


FBDD 
FBDF 
FBE1 
FBES 
FBES 
FBE7 
FBEA 
FBEC 
FBEE 
FBEF 
FBF1 
FBFS 
FBFS 
FBFS 
FBF9 
FBFB 
FBFD 
FBFF 


FCOO 
FCOS3 
FCOS 
FCO6 
FCO8 
FCOA 


B2 B3 B4 


FB 


FB 


FB 


FC 


DISPLAY HANDLER 


SCROL1: 


SCROL2: 


i DOLCOL: BDO LOGICAL COLUMN 


DOLCOL: 


DOLCOL: 


DOLCOe2: 


ee Se ee ee Tee Ty 


DOBUFC: 


DOBUFC: 


STA 
LDY 
LDA 
LDX 
DEX 
CPX 
BNE 
LDX 
CPX 
BCS 
LDA 
LDY 
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ABRESS+1 
#40 
(ADRESS }, Y¥ 
RAMTOP 


ADRESS+1 


(ADRESS?>, Y 
ADRESS 
SCROL1 
ADRESS+1 
ADRESS+1 
RAMTOP 
SCROLi 
DOLCOL 


#0 
LOGCOL 
ROWCRS 
HOLD1 
HOLD 
LOIGET 
DOLCO2 
LOGCOL 


#40 
LOGCOL 
HOLD 
DOLCOL 


LOGCOL 
COLCRS 
LOGCOL 


; LOOP 


i TEST FOR LAST LINE 


iYES SO STORE ZERO DATA FOR THIS ENTIRE LINE 


i AND RETURN 


FROM BITMAP AND COLCRS 


i START WITH ZERO 


i+4DD IN ROW COMPONENT 


i; FOUND BEGINNING OF LINE 
i ADD 40 AND LOOK BACK ONE 


iUP ONE LINE 


iADD IN COLCRS 


COMPUTE BUFFER COUNT AS THE NUMBER OF BYTES FROM 


BUFSTR TO END OF LOGICAL LINE WITH TRAILING SPACES REMOVED 


JSR 
LDA 
PHA 
LDA 
STA 
LDA 


PHACRS 
LOGCOL 


BUFSTR 
ROWCRS 
BUFSTR+1 


i START 
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5217 FCOC 85 55 STA COLCRS 

$218 FCOE A? O1 LDA #1 

5219? FCIG 85 6B STA BUFCNT 

5220 FCi2 42 17 DOBUF1: LDX #23 i NORMAL 

S221 FCi14 &A5 7B LDA SWPFLG i IF SWAPPED, ROW 3 IS THE LAST LINE ON SCREE 
S222 FCiI6 160 02 BPL DOBI 

5223 FCIS Ae O3 DX #3 

See4 FCIA E4 54 DOB1: CPX ROWCRS i TEST IF CRSR IS AT LAST SCREEN POSITION 
9229 FCiC DG OB BNE DOBUIA 

5226 FCIiE AS 55 LDA COLCRS 

Se27 FC20 C5 53 CMP RMARGN 

S228 FC22 DO O5 BNE DOBULA 

5229 FC24 E& 6B INC BUFCNT iYES, SO FAKE INCRSR TO AVOID SCROLLING 
5230 FC26 4€ 39 FC JMP DOBUF2 

S231 FC29 20 D4 FF DOBULA: JSR INCRSB 

5232 FC2C ES &B INC BUFCNT 

5293 FC2E A5 43 LDA LOGCOL 

S234 FC3O0 CS S2 CMP LMARGN 

S235 FC32 DG DE BNE DOBUF 1 iNOT YET EOL 

S236 FC34 C& $4 DEC ROWCRS i BACK UP ONE INCRSR 

S237 FC3B& 20 99 F7 JSR CRSRLF 

S238 FC39 20 A2 FS DOBUF2: JSR GETPLT i TEST CURRENT COLUMN FOR NON-ZERO DATA 
5239 FC3C BO 17 BNE DOBUF4 iQUIT IF NON-ZERO 

5240 FC3SE C& 6B DEC BUFCNT i DECREMENT COUNTER 

5241 FC4O0 AS 43 LDA LOGCOL i BEGINNING OF LOGICAL LINE YET? 
S242 FC42 CS S2 CMP LMARGN 

5243 FC44 FOC OF BEG DOBUF4 iYES, SO QUIT 

5244 FC4& 26 99 F7 JSR CRSRLF i BACK UP CURSOR 

5245 FC49 AS 55 LDA COLCRS i IF LOGCOL=RMARGN, GO UP i ROW 
S244 FC4B ¢5 53 CMP RMARGN 

S247 FC4D BO 62 BNE DOBUFS 

5248 FC4F C& S54 DEC ROWCRS 

5249 FCS5Si1 AS 6B DOBUFS: LDA BUFCNT 

5250 FC53 po £4 BNE DOBUF2 ;LOOP UNLESS BUFCNT JUST WENT TO ZERO 
S291 FCSS 648 DOBUF4: PLA 

5252 FCS& 85 63 STA LOGCOL 

5253 FCS8 20 AS FC JSR PLACRS 

5254 FCSB 40 RTS 

5255 — i 

5256 3 

5257 i 

5258 i 

5259 i STRBEG: MOVE BUFSTR TO BEGINNING OF LOGICAL LINE. 

S240 i 

3261 FCSC 20 DB FB STRBEG: JSR DOLCOL iUSE DOLCOL TO POINT HOLD1i AT BOL 
S262 FCSF AS $1 LDA HOLDi 

3263 FC4&1 85 4¢ STA BUFSTR 

3264 FCS3 AS S52 LDA LMARGN 

9265 FC65 85 46D STA BUFSTR+1 

9266 FCS7 40 RTS 

3267 i 

5268 i 

5269 i 


5270 


ERR LINE 


S27 1 
se72 
3273 
5274 
5275 
9276 
$277 
3278 
5279 
5280 
S261 


ADDR 


FC48 
FCG6A 
FC&C 
FC6E 
FC70 
FC73 
FC7S 
FC77 
FC79 
FC7C 
FC7E 
FC7F 
FCS1i 
FC82 
FC84 
FC864 
FC87 
FC89 
FC8c 


FC8D 
FC8F 
FC92 
FC9S 
FC97 
FC?6 
FC99 
FCIA 
FC9C 


FC9D 
FCOF 
FCAL 
FCA4 
FCAS 
FCA7 


FCAS 
FCAA 
FCAD 


Bi 


FS 


BS B4 


FB 


F9 


Fo 


FE 


02 


02 
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DISPLC PAGE 


i DELTIM: TIME TO DELETE & LINE IF IT IS EMPTY AND AN EXTENSION 


DELTIA: 


DELTIB: 
DELTIM: 


DELTI1: 


DELTI2: 
DELTI3: 


i 


LDA 
CMP 
BNE 
DEC 
JSR 
LDA 
CMP 
BEG 
JSR 
LDA 
SEC 
SBC 
TAY 


LDA © 


BNE 
DEY 
BPL 
JMP 
RTS 


LOGCOL 
LMARGN 
DELTIB 
ROWCRS 
DOLCOL 
LOGCOL 
LMARGN 
DELTIS i NO 
CONVRT 
RMARGN 


LMARGN 


(ADRESS}, Y 
DELTIS 


DELTI1 
DELLIB 


iIF LOCCOL<S>LMARGN 
i THEN DONT MOVE UP ONE 
iLINE BEFORE TESTING DELTIM 


i TEST FOR EXTENSION 


i SET UP COUNT 


i FOUND A NON-O SO QUIT AND RETURN 


iDELETE A LINE AND RETURN 


; TSTCTL: SEARCH CNTRLS TABLE TO SEE IF ATACHR IS A CNTL CHAR 


TSTCTL: 
TSTCT1: 


TSTCT2: 


PHACRS: 
PHACR1: 


PLACRS: 
PLACRIL: 


LDX 
LDA 
CMP 
BEG 
DEX 
DEX 
DEX 
BPL 
RTS 


#45 
CNTRLS, X 
ATACHR 
TSTcT2 


TSTCcT1 


ROWCRS, COLCRS AND COLCRS+1 


LDX 
LDA 
STA 
DEX 
BPL 
RTS 


#2 
ROWCRS, X 
TMPROW, X 


PHACRI 


COLCRS+1, COLCRS AND ROWCRS 


LDX 
LDA 
STA 


#2 
TMPROW, X 
ROWCRS, X 


iPREPARE TO SEARCH TABLE 


117 


ERR LINE 


9325 
9326 
3327 
5328 
5329 
5330 
9331 
S332 
9333 
5334 
3335 
5336 
5337 
5338 
9339 
5340 
9341 
5342 
3343 
5344 
$345 
5346 
3347 
5348 
5349 
9350 
S351 
9352 
5353 
9354 
S355 
3356 
9357 
9358 
9359 
9360 
9361 
9362 
9363 
3364 
9365 
93366 
2367 
5368 
5369 
9370 
9371 
9372 
9373 
9374 
S375 
9376 
S377 
9378 


ADDR 


FCAF 
FCBO 
FCB2 


FCB3 
FCB& 
FCB9 
FCBC 
FCBE 
FCCO 
FCC2 
FCC4 
FCCS 
FCC8 
FCCA 
FCCB 
FCCE 
FCCF 
FCD1 
FCD3 
FCDS 
FCD7 


FCD8 
FCDA 
FCDD 
FCEO 
FCE1 
FCES 


FCE4 
FCES 
FCE8 
FCEA 
FCEC 
FCEE 
FCFO 
FCF2 


FCF3 
FCFS 


AS 
85 


B2 BS B4 


FS 


7F 
1F 
OA 


F7 


58 
64 


FC 


02 


02 


02 


BO 
D4 
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DEX 
BPL 
RTS 


TT 


SWAP : JSR 
JMP 
SWAPA: LDA 
CMP 
BEG 
LDX 
SWAP1: LDA 
PHA 
LDA 
STA 
PLA 
STA 
DEX 
BPL 
LDA 
EOR 
STA 
SWAPS: RTS 


j 


PLACRI 


SWAP: IF MIXED MODE. SWAP TEXT CURSORS WITH REGULAR CURSORS 


SWAPA i THIS ENTRY POINT DOES RETURi 
RETUR 1 

BOTSCR 

#24 

SWAPS 

#11 

ROWCRS, X 


TXTROW, X 
ROWCRS, X 


TXTROW, X 


SWAP 1 
SWPFLG 
#$FF 

SWPFLG 


i; CLICK: MAKE CLICK THROUGH KEYBOARD SPEAKER 


CLICK: LDX 
CLICKi: STX 
STX 
DEX 
BPL 
RTS 


oO or 


OLCR: LDA 
LDX 
BNE 
LDX 
BNE 
COLCR1I: LDA 


‘COLCR2: STA 


RTS 


#$7F 
CONSOL 
WSYNC 


CLICK 


COLCR: PUTS EITHER O OR LMARGN INTO COLCRS BASED ON MODE AND SWPFLG 


#0 

SWPFLG 
COLCRI 
DINDEX 
COLCR2 
LMARGN 
COLCRS 


PUTMSC: PUT SAVMSC INTO ADRESS 


PUTMSC: LDA 
STA 


SAVMSC ;SET UP ADDRESS 
ADRESS 


ERR LINE 


3379 
5380 
9381 
93382 


ADDR 


FCF7 
FCF9 
FCFB 


Bi Be BS B4 


AS 3? 
65 65 
46 


DISPLAY HANDLER -- 10-30-78 -- BISPLC 
LDA SAVMSC+1i 
STA ADRESS+1 
RTS 


PAGE 


119 


ERR LINE 


5383 
9384 
S385 
9386 
3387 
5388 
5389 
5390 
S391 
S392 
9393 
5394 
3395 
9396 
9997 
5398 
D39F 
5400 


3401 


5402 
9403 
5404 
3405 
9406 
5407 
9408 
5409 
5410 
9411 
9412 
9413 
9414 
9415 
9416 
S417 
9418 
9419 
9420 
9421 
9422 
9423 
9424 
9429 
9426 
3427 
5428 
9429 
9430 
S431 
9432 
9433 
9434 
9435 
9436 


ADDR 


FCFC 
FCFE 
FDOO 
FDO2 
FDO4 
FDO6 
FDOS 
FDOA 
FDOB 
FDOC 
FDOF 
FD11 
FD13 
FD1i5 
FD17 
FD19 
FD1B 
FD1iD 
FDIF 
FD21 
FD22 
FD24 
FD26 
Fb28 
FD2A 
FD2c 
FD2E 
FD30 
FD32 
FD33 
FD35 
FD37 
FD38 
FDA 
FD3C 
FD3E 
FD40 
FD42 
FD44 
FD46 
FD48 
FD4A 
FD4C 
FD4E 
FD50 
FD52 
FD54 
FD56 
FD58 


Bi 


B2 BS B4 


02 


DISPLAY HANDLER 


. PAGE 


-- 10-30-78 -- 


DISPLC PAGE 


i BRAW -- DRAW A LINE FROM OLDROW, OLDCOL TO NEWROW, NEWCOL 
i (THE AL MILLER METHOD FROM BASKETBALL ) 


DRAW: LDX 
LDA 
CMP 


DRAWB: INX 
DRAWA: STX 


DRAW1: SEC 


#NVALID 


FILFLG 
ROWCRS 
NEWROW 
COLCRS 
NEWCOL 
COLCRS+1 
NEWCOL+1 
#1 
ROWINC 
COLINC 


NEWROW 
OLDROW 
DELTAR 
DRAW1 
#$FF 
ROWINC 
DELTAR 
#$FF 


#1 
DELTAR 


NEWCOL 
OLDCOL 
DELTAC 
NEWCOL+1 
OLDCOL+1 
DELTAC+1 
DRAW2 
#$FF 
COLINC 
DELTAC 
#$FF 
DELTAC 
DELTAC+1 
#$FF 
DELTAC+1 
DELTAC 


DRAW2 


i TEST COMMAND: $11=DRAW $12=FILL 


i TEST FILt 


i YES 
iNO, SO RETURN INVALID COMMAND 


*+PUT CURSOR INTO NEWROW, NEWCOL 


i SET UP INITIAL DIRECTIONS 
iDETERMINE DELTA ROW 


iDO DIRECTION AND ABSOLUTE VALUE 
i BORROW WAS ATTEMPTED 
i SET DIRECTION=DOWN 


iDELTAR = [DELTARi 


iNOW DELTA COLUMN 
i TWO-BYTE QUANTITY 


i DIRECTION AND ABSOLUTE VALUE 
i BORROW WAS ATTEMPTED 
i SET DIRECTION = LEFT 


iDELTAC = {DELTACi 


i ADD ONE FOR TWOS COMPLEMENT 


120 


ERR LINE 


5437 
5438 
5439 
5440 
5441 
5442 
3443 
5444 
5445 
5446 
5447 


5448 © 


5449 
5450 
5451 
5452 
5453 
5454 
5455 
5454 
5457 
5458 

5459 
5440 
5461 
5442 
5463 
5464 
5465 
5466 
5467 
5448 
3449 
5470 
5471 
5472 
5473 
5474 
5475 
5476 
5477 
5478 
5479 
5480 
5481 
5492 
5483 
5484 
5485 
5486 
5487 
5488 
5489 
5490 


Be B3 B4 


78 


FE 


DISPLAY HANDLER -- 10-30-78 -- DISPLC PAGE 
INC DELTAC+i 
DRAW2: LDX #2 ; ZERO RAM FOR DRAW LOOP 
LDY #0 
STY COLAC+1 
DRAW3A: TYA 
STA ROWAC, X 
LDA OLDROW, X 
STA ROWCRS, X 
DEX 
BPL DRAW3A 
LDA DELTAC ;FIND LARGER ONE (ROW OR COL) 
STA COUNTR (PREPARE CQUNTR AND ENDPT? 
STA ENDPT 
INX iMAKE X O 
TAY 
LDA DELTAC+i 
STA COUNTR+1 
STA ENDPT+i 
BNE DRAWS ; AUTOMATICALLY LARGER IF MSD>O 
LDA DELTAC 
CMP DELTAR ;LOW COL >LOW ROW? 
BCS DRAWS i YES 
LDA DELTAR 
LDX #2 
TAY 
DRAW3: TYA ;PUT IN INITIAL CONDITIONS 
STA COUNTR 
STA ENDPT 
PHA os iSAVE AC 
LDA ENDPT+i ;PUT LSB OF HIGH BYTE 
LSR A i INTO CARRY 
PLA iRESTORE AC 
ROR A ;ROR THE 9 BIT ACUMULATOR 
STA ROWAC, X 
DRAW4A: LDA COUNTR i TEST ZERO 
ORA COUNTR+1 
BNE DRAW1 1 i IF COUNTER IS ZERO, LEAVE DRAW 
JUMP DRAWLO 
DRAWi1: CLC ADD ROW TO ROWAC (PLOT LOOP) 
LDA ROWAC 
ADC DELTAR 
STA ROWAC 
BCC DRAWS 
INC ROWAC+1 
DRAWS: LDA ROWAC+1 ; COMPARE ROW TO ENDPOINT 
CMP ENDPT+1 ;IF HIGH BYTE OF ROW IS .LT. HIGH 
BCC DRAW6 iBYTE OF ENDPT, BLT TO COLUMN 
BNE DRAWSA 
LDA ROWAC 
CMP ENDPT ;LOW BYTE 
BCC DRAWS i ALSO BLT 
DRAWSA: CLC ;GE SO MOVE POINT 
LDA ROWCRS 
ADC ROWINC 


112i 


ERR LINE 


5491 
5492 
5493 
5494 
5495 

(5496 

‘5497 
5498 
5499 
5500 
$501 
5502 
5503 
5504 
2905 
5506 
5507 
5508 
5509 
5510 
5511 
5512 
5513 
5514 
5515 
5516 
5517 
5519 
5519 
5520 
5521 
5522 
5523 
5524 
5525 
5526 
5527 
5528 
5529 
5530 
5531 
5532 
5533 
5534 
5535 
5596 
5537 
5538 
5539 
5540 
5541 
5542 
5543 
5544 


ADDR 


FDB7 
FDB9 
FDBB 
FDBE 
FDBF 
FDC1 


FDC3 | 


FDCS 
FDC7 
FDC? 
FDCB 
FDCD 
FDCF 
FDD1 
FDDS 
FDDS 
FDD7 
FDD9 
FDDB 
FDDD 
FDDF 
FDE1 
FDES 
FDES 
FDE?7 
FDE? 
FDEB 
FDED 
FDEF 
FDF1 
FDF3 
FDFS& 
FDF9 


FDFC. 


FDFF 
FEOL 
FEO4 
FEO7 
FEOA 
FEOC 
FEOD 
FE10 
FE11 
FEi3 
FE16 
FE19 
FEIB 
FELE 
FE21 
FEQ4 
FE27 
FE2A 
FE2D 
FE30 


B2 B3 B4 


FA 


DISPLAY HANDLER 


DRAW6: 


DRAWGA: 


DRAWGB: 


DRAW7: 


| DRAWS: 


DRAWBA: 


DRAWAC: 


DRAWEB: 


DRAW?: 


STA 
LDX 
JSR 
CLC 
LDA 
ADC 
STA 
LDA 
ADC 
STA 
CMP 
BCC 
BNE 
LDA 
CMP 
BCC 
BIT 
BPL 
DEC 
LDA 
CMP 
BNE 
LDA 
BEG 
DEC 
BPL 
INC 
BNE 
INC 
LDX 
JSR 
JSR 
JSR 
LDA 
BEG 
JSR 
LDA 
STA 
LDA 
PHA 
JSR 
PLA 
STA 
JSR 
JSR 
BNE 
LDA 


STA 


JSR 
JMP 
LDA 
STA 
JSR 
SEC 
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ROWCRS 


COLAC+1 


DELTAC+1 


COLAC+1 
ENDPT+1 
DRAWS 
DRAWGA 
COLAC 
ENDPT 
DRAWS 
COLINC 
DRAW4SB 
COLCRS 
COLCRS 
#$FF 
DRAW7 


COLCRS+1 


DRAW? 


COLCRS+1 


DRAW7 
COLCRS 
DRAW7 


COLCRS+1 


ROWCRS 


INCRSA 


ROWCRS 
RANGE 

GETPLT 
DRAWSB 
FILDAT 
ATACHR 
OUTPLT 
DRAWBA 
HOLD4 

ATACHR 
PLACRS 


i AND SUBTRACT ENDPT FROM ROWAC 


i DO SAME FOR COLUMN (DOUBLE BYTE ADD) 
; ADD 


; COMPARE HIGH BYTE 
i COMPARE LOW BYTE 


i+ OR - 7? 


i; DO DOUBLE BYTE DECREMENT 


iDON‘T DEC IF ZERO 
i CUNCONDITIONAL > 
+ DO DOUBLE BYTE INCREMENT 


;AND SUBTRACT ENDPT FROM COLAC 


iPLOT POINT 
i TEST RIGHT FILL 


i SAVE ROW IN CASE OF CR 
iPOSITION CURSOR ONE PAST DOT 
i#RESTORE ROWCRS 


iGET DATA 
i STOP IF NON-ZERO DATA IS ENCOUNTERED 
iFILL DATA 


i DRAW IT 
i LOOP 


i DO DOUBLE BYTE SUBTRACT 
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ERR LINE 


3945 
3546 
5547 
5548 
3949 
55506 
9951 
9552 
9553 


ADDR 


FES1 
FE33 
FESS 
FEQ7 
FE39 
FESB 
FE3D 
FESF 
FE42 


Be BS B4 


DISPLAY HANDLER 


DRAW10: 


LDA 
SBC 
STA 
LDA 
SBC 
STA 
BMI 
JMP 
JMP 
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COUNTR 
#1 
COUNTR 
COUNTR+1 
#0 
COUNTR+1 
DRAW1O 
DRAW4A 
RETURI 


PAGE 


123 
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5554 . PAGE 
$555 i 
5556 i 
$557 . i TABLES 

5554 i 

53559 i 

5540 i 

5541 j 

5562 FE45 18 10 OA OCA ALOCAT: . BYTE 24,14. 10,10, 14, 28, 52, 100, 196, 196, 196, 196 
55639 FE49 16 1C 34 64 

3964 FE4D C4 C4 C4 C4 


MEMORY ALLOCATION 


5545 i 

5544 i 

3567 i NUMBER OF DISPLAY LIST ENTRIES 

5548 : 

5569 FES51i 17 17 OB i7 NUMDLE: . BYTE 23,23, 11, 23, 471 47,95. 95. 97. 971 97, 97 


9570 FESS 2F 2F SF SF 
S571 FESS 61 41 61 41 
$572 FESD 13 13 09 13 MXDMDE: . BYTE 19,19, 9, 19, 39, 39, 79, 79, 65, 65, 65,65 3; (EXT OF NUMDLE) 
9573 FES1 27 27 4F 4F 
S574 FE65 41 41 41 41 


5575 

5576 

5577 ; ANTIC CODE FROM INTERNAL MODE CONVERSION TABLE 

5578 

5579 ; INTERNAL ANTIC CODE DESCRIPTION 

5580 0 2 40X2X8 CHARACTERS 

5581 i é 20X5x8 wn 

5582 2 7 2OX5X14 wa 

5583 3 8 AOX4X8 GRAPHICS 

wees i 4 9 BOX2X4 un 

5585 5 A BOX4X4 un 

5586 b B 140X2X20=«" 

5587 7 D 160X4X20 

5588 8 F 320X2K1 "4 

5589 9 SAME AS @ BUT GTIA ‘LUM’ MODE 

5590 i0 SAME AS 8 BUT GTIA ‘COL/LUM REGISTER’ MODE 
5591 11 SAME AS 8 BUT GTIA ‘COLOR’ MODE 

9992 i 

5593 FE49 02 06 07 08 ANCONV: .BYTE 2, 6, 7, 8, 9, $A, $B, $D, $F, $F, $F, $F i ZEROS FOR RANGE TEST IN 


5594 FE4D O97 OA OB OD 
$9595 FE71 OF OF OF OF 


5596 i 
3997 i 
5598 ; PAGE TABLE TELLS WHICH DISPLAY LISTS ARE IN DANGER OF 
2599 i CROSSING A 2546 BYTE PAGE BOUNDARY 
3400 ; 
Pp 


S601 FE7S 066 00 00 00 
$602 FE79 GC 00 00 01 
9603 FE7D G1 O1 O1 O1 


AGETB: . BYTE 0,6,0,0,0,0.0,1,1,1,1,1 


5604 i 

53605 i : 

5406 i THIS IS THE NUMBER OF LEFT SHIFTS NEEDED TO MULTIPLY 
5407 i COLCRS BY 10,20. OR 40. (ROWCRS#10) /.(2**DHLINE) 


ERR LINE 


5608 
9609 
3410 
S611 
94612 
S613 


ADDR 


FEB1 
FEBS 
FEa? 


FE8D 
FE?1 
FE9S 


FE99 
FE9D 
FEAL 


FEAS 
FEA? 
FEAD 


FEBI 
FEBS 


FEB9 
FEBD 


FECL 
FECS 


FECS6 
FEC7 


28 


4G 


18 
30 
CO 


iB 
79 


14 


30 


CA 


F7 


14 


50 


oc 


co 


94 


4& 


DISPLAY 


DHLINE: 


COLUMN: 


COLUMN: 


NOROWS: 


wee ee mee 


NOROWS : 


DIV2TB: 


IV2TB: 


o ee Te Te ee Td 


DMASKT: 


a Tet) 


DMASAT: 


HANDLER -- 10-30-78 -- DISPLC PAGE 125 


. BYTE 2.1,1,0,0,1,1,.2,2,2,2,2 


NUMBER OF COLUMNS 


. BYTE 40, 20, 20, 40, 80, 80, 160, 160, 64, 8G, 80, 80 i; MODE & IS SPECIAL 


NUMBER OF ROWS 


. BYTE 24, 24,12, 24, 48, 48. 94, 96, 192, 192, 192, 192 


HOW MANY RIGHT SHIFTS FOR HCRSR FOR PARTIAL BYTE MODES 


. BYTE 0,6,.6,2,3,2:3,2,3:1,1,1 


DISPLAY MASK TABLE 


. BYTE $00, $F F, $FO, SOF 


. BYTE $CO, $36, $0C, $03 


i MASKTB: 


MASKTB: «. 


CNTRLS: 


NTRLS: 


BIT MASK. (ALSO PART OF DMASKTB! DO NOT SEPARATE? 


BYTE $86, $46, $20, $10, $08, $04, $02, $01 


. BYTE $28, $CA, $94, $46, $00 


CONTROL CODES AND THEIR DISPLACEMENTS INTO THE 
CONTROL CHARACTER PROCESSORS 


. BYTE $iB 


. WORD ESCAPE 


ERR LINE 


3462 
$663 
5464 
9469 
9666 
5667 
5668 
3669 
5470 
S671 
3472 
3473 
3674 
S675 
95676 
54677 
3678 
5479 
54680 
5481 
3482 
5483 
9484 
3685 
5686 
3687 
9688 
3689 
3490 
S691 
9692 
9693 
9694 
S495 
9696 
9697 
9498 
9699 
9700 
S701 
9702 
9703 
3704 
3705 
3704 
_ 3707 
9708 
3709 
3710 
o711 
S712 
9713 
9714 
97195 


ADDR 


FEC9 
FECA 


FECC . 


FECD 
FECF 
FEDO 
FED2 
FED3 
FEDS 
FEDG 
FEDS 
FED? 
FEDB 
FEDC 
FEDE 
FEDF 
FEE1 
FEE2 
FEE4 
FEES 
FEE7 
FEES 
FEEA 
FEEB 
FEED 
FEEE 
FEFO 
FEF 1 
FEFS 
FEF4 


FEFS6 


FEFA 


FEFE 
FFO2 
FFOG 
FFOA 
FFOE 
FF OE 
FFi2 


4G 


26 


Be BS B4 


F7 
F7 
F7 
F7 
F7 
F7 
FS 
FA 
Fa 
Fa 
FS 
FS 
F 
FS 


FS 


OG 


40 


20 


00 


&G 


&0 


DISPLAY HANDLER 


. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 
. BYTE 
. WORD 


i 
i 
; 
i 
; 
i 


ATAINT: 


TAINT: 


INTATA: 


A 

é 
INTATA: 
i ATASCI: 
A 


TASCI: 


-- 10-30-78 -- DISPLC 


Sic 
CRSRUP 
$1D 
CRSRDN 
$1E 
CRSRLF 


INSCHR 


ATASCI TO INTERNAL TABLE 


. BYTE 


$40, $06, $20, $40 


INTERNAL TO ATASCI TABLE 


. BYTE 


$20, $40, $00, $40 


ATASCII CONVERSION TABLE 


. BYTE 


. BYTE 


. BYTE 


$40, $44, $3B, $80, $86, $43, $28, $2A ; LOWER CASE 


$4F, $86, $70, $75, $9B, $69, $2D, $3B 


$74, $86, $43, $80, $80, $62, $78, $74 


PAGE 
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ERR LINE 


9716 
9717 
3718 
9719 
9720 
S721 
$722 
3723 
3724 
5725 
3726 
5727 
9728 
9729 


DISPLAY HANDLER 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


BYTE 


. BYTE 


BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


. BYTE 


-- 10-30-78 -- DISPLC 


$34, $80, $33, $34, $18, $35, $32, $31 


$2C, $20, $2E, $6E, $80, $4D, $2F, $81 


$72, $60, $65, $79, $7F, $74, $77, $71 
$39, $80, $30, $37, $7E, $38, $3C, $3E 
$46, $68, $644, $80, $82, $67, $73, $41 
$4C, $44, $3A, $80, $80, $4B, $5C, $5E 


$4F, $80, $50, $55, $9B, $49, $5F, $7C 


$56, $80, $43, $80, $80, $42, $58, $54 


$24, $80, $23, $26, $1B, $25, $22, $21 


$5B, $20. $5D, $4E, $80, $4D, $3F, $81 


$52, $80, $45, $59, $9F, $54, $57, $51 
$28, $80, $29, $27, $9C, $40, $7D, $9D 
$46, $48, $44, $80, $83, $47, $53, $41 
$0C, SOA, $7B, $80, $80, $OB, $1E, $iF 


$OF, $80, $10, $15, $9B, $09, $1C, $1D 


$16, $80, $03, $80, $80, $02, $18, $1A 


$6C, $8C, $85, $80, $18, $80, $FD, $80 


$00, $20, $40, $0E, $80, $0D, $80, $81 


$12, $80, $05, $19, $9E, $14, $17, $11 


$80, $80, $80, $80, SFE, $80, $7D, $FF 


$06, $08, $04, $80, $84, $07, $13, $01 


iUPPER CASE 


i; CONTROL 


PAGE 
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5770 ; 

3771 3 

5772 i 

5773 i 

5774 : 

5775 FFBE AD O09 De PIRGS: LDA KBCODE 

S776 FFCi cB F2 G2 CMP CHI i TEST AGAINST LAST KEY PRESSED 
5777 FFC4 bo 05 BNE PIRGS i IF NOT, GO PROCESS KEY 

5778 FFC6& AB Fi 02 LDA KEYDEL i IF KEY DELAY BYTE > 0 

5779 FFC9 bG 20 BNE PIRG4 i IGNORE KEY AS BOUNCE 

S780 FFCB AD 09 Be PIRG@S: LDA KBCODE iRESTORE AC 

5781 FFCE C9? 9F CMP #CNTLI i TEST CONTROL 1 (SSFLAG) 

5782 FFDO DBO OA BNE PIRGL 

5783 FFD2 AD FF O02 LBA SSFLAG 

5784 FFDS 49 FF EOR #$FF 

5785 FFD7 8D FF O02 STA SSFLAG 

5786 FFDA BG OF BCS PIRG4 i CUNCONDITIONAL) MAKE “1 INVISIBLE 
5787 FFDC 8B FC 02 PIRQi: STA CH 

5788 FFDF sb F2 02 STA CHi 

5789 FFE2 A? 03 LDA #3 

S79O FFE4 8D Fi O02 STA KEYDEL i INITIALIZE KEY DELAY FOR DEBOUNCE 
5791 j%FFE7Z7 A? 06 LDA #0 i; CLEAR COLOR SHIFT BYTE 
5792 FFE9 685 4D STA ATRACT 

5793 FFEB A? 306 PIRG4: LDA #$30 

5794 FFED 8D 2B 02 STA SRTIMR 

5795 FFFO 68 . PIRG2: PLA 

5796 FFFi 406 RTI 

9797 i 

5798 i 

9799 FFF2 FF FF FF FF . BYTE $FF,$FF, $FF, $FF, $FF, $FF 

5800 FFF& FF FF 

2801 i 

5802 FFFS CRNTPC = 

5803 #=$14- 

5804 0014 66 KBDSPR: . BYTE $SFFFE-CRNTPC ; “GDISPLC IS TOO LONG 

S805 oOG15 . END 


ASSEMBLY ERRORS = Oo 


LABEL 


ACK 
ACKREC 
ABDBCOR 
ADJ1 
ADJUST 
ADRESS 


ABRTAB 


APPEND 
APPMHI 
ASCCO1L 
ASC ZER 
ATACHR 


ATAINT 
ATAN 
ATASCI 
ATEOF 
ATRACT 
AUDC 1 
AUDC2 
AUDC3 
AUDC4 
AUDCTL 
AUDF 1 
AUDF2 
AUDF3 
AUDF4 
Bi92HI 
Bi92L0 
B&Q0HI 
B400LO 
BAD 
BADCOM 
BADDSK 
BADIOC 


VALUE 


0041 
EFC6 
O30E 
EDOC 
EDO4 
0064 


E6FE 
DS00 
D208 
FAO0E 
FE45 
FE469 
D400 


0001 
OOOE 
F705 
0030 
O2FB 


FEFSG 
BE43 
FEFE 
FOOB 
004D 
D201 
D203 
D205 
D207 
D208 
D200 
D202 
D204 
D206 
0000 
0028 
0005 
0occ 
EAG3 
E?BF 
F306 
0086 


CROSS 
REFERENCE 
“1632 1902 

1785 ~-1794 
-498 2519 
2933 -2537 
2470 2473 
-269 4120 
4186 4252 
4355 4357 
4453 4655 
48742 4766 
5101 5104 
$171 5175 
-1292 1327 
~374 
~839 
3686 -3891 
4146 -5542 
4139 -3593 
-735 736 
743 744 
“iit 
~i79 4761 
4478 -4480 
-~764 1193 
-469 4308 
4421 4428 
9300 $527 
4343 -5699 
~602 
4480 -5709 
3250 -3256 
~248 1340 
~667 2343 
-669 2354 
-471 2349 
~&73 
7674 2336 
~666 2297 
-648 2295 
~670 1749 
-672 i751 
“164i 1750 
~1640 1748 
“1643 22604 
-~1642 2202 
1919 -1925 
1782 -1788 
-3887 3923 
-142 826 


DISPLAY HANDLER 


REFERENCE 
2519 2523 

~2532 

4145 4171 
4254 4258 
4426 4443 
4681 4686 
4834 4895 
5106 5149 
5176 5178 
737 738 
745 746 
4765 

4311 4316 
4481 4515 
5598 5542 
i395 1401 
2353 2378 
2203 2607 
2205 2609 
1809 

3929 


4173 
4240 
4445 
4748 
483e 
Siéi 
9179 


739 
747 


4333 
4524 


14603 


3200 
3202 


mo AOS 30-78 = 

4182 4183 
4263 4265 
4570 4573 
47355 4758 
4839 S092 
$143 5145 
5287 5378 

740 741 
748 749 
4372 43974 
4528 4606 
9792 


DISPLC 


4184 
4296 
4574 
4760 
5094 
5168 
5380 


742 
750 


4417 
5082 


PAGE 


1 


2 


9 


BADMOD 0091 -154 4141 


BADST EE9SE 29714 2917 2963 -2945 

BEEP FOSS 3164 3197 -3314 

BEEP 1 FOSA -3315 3349 

BEGIN ED10 2255 -2558 2570 

BELL FIOA 4402 -472& 5687 

BELLI F?OC ~4727 4729 

BFENHI 0035 -224 1774 1886 1985 2147 2184 

BFENLO 0034 ~223 1771 #1883 1983 2145 2179 

BITCLR FBi2 4624 $038 -5046 

BITCON FAEB -5019 5040 S046 S056 

BITGE1 FBS1 3060 -506é2 

BITGET FB25 : 4418 4890 -5056 

BITMSK 006E ~276 S023 5042 S047 Sos? 

BITPUT FBO4 4711 -5038 S129 5138 

BITROL FAFA -S032 5159 

BITSET FBOG 4622 -5040 

BLACKB Fe2A ~3740 3741 

BLFILL EECi 2992 -2995 3015 

BLIM 02BA ~398 3183 3235 3254 

BLKB2 F230 3740 -3742 

BLKBDV E471 -77 3483 3601 3403 

BLOAD F346C 3928 -3933 

BOOT F2CF 3710 ~-3862 

BOOTAD 0242 -360 3896 3898 3934 3937 

BOOT? 0009 -176 3864 3931 3991 4007 

BOTSCR O2BF -429 4193 4201 4542 4548 44664 4953 5335 

BPTR 003D -234 3182 93225 3234 3298 3246 3243 3265 
3274 3293 

BRKABT 0080 -136 2637 31688 4466 4983 

BRKKEY 0011 -184 1337 1957 2064 2558 2580 2643 3189 
3220 3831 4467 4509 4984 4985 

BRKKY 0236 -345 1292 38993 3835 

BRKKY2 E754 “1936 3832 3834 

BROKE EDAO 1959 2066 2560 2581 -2632 

BS F7E& -4591 5473 

BS1 FBOD 4593 -4608 

BS2 F8OS 4601 4603 -4605 

BS3 F7FS 45976 ~43598 

BSA F7EC ~4SF4 

BUFADR 0015 -187 2829 2838 2842 2863 2865 

BUFCNT O06B ~274 4386 4410 4412 S219 S229 S232 5240 
3249 

BUFFH 0004 -3421 3422 3883 

BUFFL 0000 -3422 3861 

BUFFUL EECB 2989 -3000 

BUFRFL 0038 ~227 2054 2111 2140 

BUFRHI 0033 -222 1773 1885 1980 1984 2142 2144 2182 
2624 2626 

BUFRLO 0032 -221 1769 1881 1951 1978 #1982 2009 2133 
2140 2144 2177 2615 2617 2621 2623 

BUFSTR 0046C -275 4389 4391 4406 4408 4584 4588 4927 


$214 $216 S263 $265 


CAINI 
CART 
CARTAD 
CARTCS 
CARTFG 
CASS1 
CASBUF 


CASENT 
CASET 

CASETV 
CASFLG 
CASINI 
CASORG 
CASRED 


CASSBT. 


CASSET 
CASSPR 
CAUX1 

CAUX2 

CBAUDH 
CBAUDL 
CBINI 

CBUFH 

CBUFHI 
CBUFL 

CBUFLO 
CCOMND 
CDEVIC 
CDTMAL 
CDTMA2 
CDTMFS 
CDTMF4 
CDTMFS 
CDTMV1 


CDTMV2 


CHKSUM 


-3750 
3458 
3750 
3720 
3702 

~2357 
3101 
3389 
3905 

-2197 
1732 
3118 
1739 
4009 
3097 

-“2293 
3888 


1763 
1745 
2602 
2601 
“37351 
3102 
1670 
3348 
1768 
1740 
1669 
1528 
1529 
1455 


1451 
1546 


~3075 
1478 
9776 
1442 
1443 
4302 
1440 
1441 
-~2002 
2118 
1947 
1946 


3666 
3751 
3726 
3705 


3102 
3391 


2289 
3513 
2050 
4011 
3136 


3922 


2608 
2406 


3346 
1772 


1470 
2653 


3177 


1452 


4087 
5788 
4110 


4344 
4108 


2017 


1988 
1955 


1757 
2455 


3179 


1535 


4462 


4346 


1994 
1991 


3975 


3219 


1537 


4469 


50649 


2026 
2013 


3784 


3786 


3253 
3422 


4001 


3222 


1539 


4474 


S079 


2015 


3793 
3264 3295 
3892 39700 
4005 
1540 1542 
9787 
2053 2115 


CHKTIM 
CHRORG 
cICLOZ 
CICLOS 
CIERR1 
CIERR2 
CIERRS 
CIERR4 
CIUUMP 
CINI 
cro 
CIOCHR 


cIOI1 
CIOINT 
CLOINV 
CIOORG 
CIOPEN 
CIOSPR 
CIOV 
CIREAD 
CIRTS 


EAF9 
E000 
ES3SF 
ES33 
E4D1 
EGBG 
ESOF 
ESi1 
E493 
FSE1 
E4c4 
O02F 


E4A8 
E4A6 
E46E 
E4A6 
ESO9 
0014 
E456 
ES6? 
E62B 
E41B 
E461D 
ES5S9 
ES4E 
ESC9 
OOF 2 
0044 
EE11 
FCDS 
FCDA 
OcOoCc 
FO2B 
F27A 
007D 
FBAG 
FB9B 
F140 
F7BF 
F7CE 
F7B9 
F832 
F430 
007D 
FO38 
EFIE 
E6FS6 
OO9F 
FECSG 
0072 
DOIA 


2138 
2071 


~-903 
-898 
-B26 
-1183 


~870 
-1158 
-4014 
~815 
815 
1037 
798 
~786 
774 
783 
~B64 


770 
~934 
1080 

870 

909 
-923 
-914 

-1003 


3856 
-2810 
4727 
3359 


-3286 
3825 
4312 
5151 

-5144 
3594 
4572 
4581 
4314 
5483 
4127 
3527 

-3293 
3087 
1313 
5781 
4444 
5440 


2619 


874 


951 
1083 


tei2 
3850 


34683 


940 
930 


3997 


~$355 


3598 
4576 


4567 


5299 
5495 


880 920 


9356 944 985 989 


3967 


1009 -1065 
9352 999 1060 -1049 


4006 


9471 


-5660 
9497 S498 3500 3504 


io1g9 


COLCR 

COLCRI 
COLCR2 
COLCRS 


COLDST 
COLDSV 
COLING 
COLON 
COLORO 
COLORI 
COLOR2 
COLORS 
COLOR4 
COLPFO 
COLPF i 
COLPF2 
COLPFS 
COLPMO 
COLPMi 
COLPM2 
COLPM3 
COLRSH 
COLRTB 
COLUMN 
COM1 
cOM2 
COMENT 
COMFRM 
COMMND 
COMPLT 
COMPUT 
COMRE1 
COMRET 
COMTAB 
CONSOL 
CONTIN 
CONVR 1 
CONVR2 
CONVRS 
CONVR4 
CONVRS 
CONVRG 
CONVRT 
cos 
COUNT 
COUNTR 


CR 


FCE4 
FCEE 
FCFO 
0055 


0244 
E477 
OO7A 
003A 
02C4 
02C5 
02C6 
O2C7 
02C8 
DO14 
DO17 
DO18 
DO19 
DO12 
DOL 
DO14 
DOLS 
OO4F 
FEC1 
FE8D 
E647 
E662 
E63D 
E?78 
E?74 
0043 
ECAS 
F7A7 
F789 
E4&c9 
DOLF 
EC31 
FO7E 
F988 
F9BF 
FO9C 
FIAG 
FIA7 
F947 
BD73 
ED3B 
OO7E 


0098 


4582 
3947 
S349 
-259 
4587 
4B8il 
4903 
S245 
$517 
~36é1 
-79 
-284 
-7F45 
-436 
~-437 
-~438 
~439 
-440 
-7G4 
~7O0S 
-766 
-~707 
-700 
-7O1 
-702 
~703 
-250 
4129 
4865 
1095 
1099 
879 
-~1748 
~1743 
-1434 
-~2468 
4556 
4541 
850 
-713 
2307 
~4805 
4806 
~4813 
4614 
4824 
~4827 
4295 
-401 
-2580 
-~288 
59350 
-129 


4901 
-5370 
-S371 

4390 

4594 

4816 

4970 

5371 

5519 

3545 

3491 

5406 


4130 


4149 


14937 


1407 
~S6St 
4977 
-1102 
“1116 
868 
1789 
1856 
1904 
2600 
“48539 
~4545 
1107 
1432 
~2331 
4809 
-4810 
4819 
-4820 
-4826 
4830 
4345 


2591 
5453 


29971 


-5365 


4409 
4599 
4845 
4975 
5400 
3606 


$428 


1435 


-5616 


900 


4563 
4549 
-1209 
3325 


4652 


2594 
5463 


3527 


43552 
4610 
4847 
4978 
9402 
3714 


9507 


923 


4564 


3330 


4680 


2604 
5471 


3539 


4593 
4679 
4860 
9145 
3509 


943 


4558 
4719 
4862 
S202 
S910 


1012 


3ES3 5356 


4720 -4776 


S472 S545 


S551 


4317 


4560 4561 
4778 4780 
4863 4875 
5217 5226 
5513 5515 
~1093 

5146 5282 
5547 5548 
4395 4420 


CRETRI 
CRETRN 
CRETRY 
CRITIC 
CRLOOP 
CRNTP1 
CRNTP2 
CRNTPS 
CRNTP4 
CRNTPS 
CRNTPG 
CRNTP7 
CRNTPC 
CRSINH 
CRSRDN 
CRSRL1 
CRSRLF 
CRSROR 
CRSRRT 
CRSRUP 
CSBOOT 
CSBOT2 
CSIDE 
cSIo 
CSOPIV 
CSTAT 
CTIA 


CTIMHI 
CTIMLO 
CTRLC 
D 
DAUXI 
DAUXK2 
DBDDEC 
DBDEC 
DBSECT 
DBSUB - 
DBSUB 1 
DBUFHI 
DBUFLO 
DBUFSZ 
DBYTHI 
DBYTLO 
DCB 
BCOMND 


OCOD 
EBDF 
0036 
0042 
FSE7 
E4DS 
E9OB 
EDES 
EE78 
EF41 
FOES 
FSE4 
FFFS 
O2FO 
F78C 
F7A3 
F799 
00BD 
F7AA 
F77F 
F3B2 
F3CO 
EF2E 
FOAC 
E47D 
06288 
BOOO 


0000 
0002 
0092 
0044 
030A 
O30B 
FSIS 


FOIF | 


O241 


" F921 


F934 
0305 
0304 
0014 
0309 
0308 
0300 
0302 


4510 
1672 
2227 
-225 
239 
-4329 
-1213 
-1582 
-2725 
-2872 
-3093 
-3396 
-4020 
-5802 
-459 
-4546 
4554 
-4552 
-149 
-4540 
-4540 
3494 
3990 
3076 
-3370 
-81 
~396 
681 
489 
497 
705 
713 
721 
729 
1475 
-1674 
~B417 
-2901 
-494 
~495 
4188 
4178 
-359 
4148 
4759 
~489 
~488 
-2894 
-493 
~492 
-483 
-486 
3083 


1743 
“2259 
1744 
1412 
4332 
1215 
1584 
2727 
2875 
3097 
3398 
4023 
9804 
1339 
9645 
~4557 
4598 
4989 
4609 
4604 
-3989 
=S997 
~3079 


3132 


682 
690 
698 
706 
714 
722 
730 
2446 
2445 


3075 
1742 
1764 
-4740 
~4751 
3914 
4165 
~A7G1 
2181 
2176 
3077 
2183 
2178 


1759 


S361 - 


1802 


1788 
1729 


4122 


9237 


9669 
9663 


4002 


683 
691 
699 
707 
715 
723 
731 


2940 
2210 


4741 


2815 
2813 


2820 
2818 


2799 
3376 


1803 
1843 


4365 


5244 


684 
692 
700 
708 
716 
7a4 
732 


3084 
2237 


~47352 


2864 
2862 


2850 
2848 


2806 
3872 


9667 


665 
493 
7Ol 
709 
717 
Fes 
733 


3886 
2259 


3035 
3034 


3049 
3047 


26824 
3979 


686 
E94 
7C2 
710 
718 
726 


2918 
3383 


3367 
3369 


3363 
3365 


2831 


687 
495 
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GBX 
GBYTE 
GETCAR 
GETCH 
GETCHR 
GETDAT 
GETOUT 
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GETREC 
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GLBABS 
GOBACK 
GOERR 
GOHAND 
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GOODST 
GOON 
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GPRIOR 
GRACTL 
GRAFM 
GRAFPO 
GRAFP 1 
GRAFP2 
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HARDI 
HATABS 
HDR 
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-~626 
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3685 
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4000 
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HOLDS 
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ICBLLZ 
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4792 
APL 
5528 


4472 
4988 
3809 


3682 
935 


3070 
1072 
1073 
1070 
959 
1143 
1145 
1140 
947 
1126 
3676 
849 
840 


1197 
788 
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INCRS3 
INCRSA 
INCRSB 
INCRSC 
INCRSR 
INIMLH 
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1463 
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4523 
4372 


633 
1838 
3622 


4546 
SOF 


~1320 
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LOOPM 
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LOTONE 
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MODATA 
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MOTRGO 
MOTRST 
MOVLI1 
MOVL I2 
MOVLIN 
MOVVEC 
MVBUFF 
MYVNXB 

MXDMDE 


MXDMOD 
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NACK 
NARG 
NBUFSZ 
NCOMHI 
NCOMLO 
NEWCOL 
‘NEWROW 
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NMIEN 
NMIRES 
NMIST 
NOAL 
NOA2 
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-270 
4794 
4823 
1827 
-125 
-3i 
-4023 
-1664 
-1665 
-5096 
5112 
4493 
-3630 
-3904 
-3905 
A216 
-116 
-2900 
-1633 
Oo 
-2893 
1663 
-1662 
-267 
-266 
3252 
-748 
-749 
-750 
3701 
3716 
3704 


4722 
4578 
1321 
~1318 
2294 
1422 
1420 


~S645 
1094 
797 
3842 


3638 
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4796 
4825 
~1838 


3398 


2217 
1706 
5103 
—-S114 
~309 1 
3633 
3720 
3908 
—~3572 


3071 


3073 
1709 
1776 
9401 
S399 
~3254 
1270 
1384 
1372 
-3703 
3719 
-3706 


~5053 


4715 4717 4929 S032 S039 S034 


1174 

822 
3844 
3840 
4034 
4799 
4832 
3503 


2244 
2262 


3086 


2062 


9403 
9408 


1376 


~3721 


4088 
4784 
4800 
4837 


3164 
2633 


9420 


4259 
47864 
4802 


3206 
3290 


9423 


4261 
4787 4789 4791 
4807 4808 4822 


NOBOOT 
NOCAR2 
NOC ART 
NOCKSM 
NOCLR 
NOCSB2 
NOC SBT 
NODAT 
NOF UNC 
NOINIT 
NOISE 1 
NOKEY 
NOMOD 
NONDEV 
NORMAL 
NOROWS 
NOSCR1 
NOSCRL 
NOTS 
NOTCAS 
NOTCST 
NOTDER 
NOTBON 
NOTE 
NOTEND 
NOTERR 
NOTMXD 
NOTOPN 
NOTYET 
NOWARM 
NOWRPO 
NSIGN 
NTBRKO 
NTBRAI 
NTBRK2 
NTFRAM 
NTOVRN 
NTWRP 1 
NUMDLE 
NVAL ID 
NWOK 
NXTENT 
ODNHI 
ODNLO 
OFFCRS 
OKTIMI 
OKTIMR 
OLDADR 
OLDCHR 
OLDCOL 
OLDROW 
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OPENC 


FLIFF 
F220 
FLIFC 
003 
EAE? 
FSBF 
F3EO 
0000 
F63D 
F2DC 
EC45 
F2CE 
F4AB 
0082 
004E 
FE99 
FA32 
FAC 
F48B 
ECOC 
EP6B 
EAS2 
EAG1 
0026 
EABE 
EA0O 
F4F5 
0085 
EB3C 
F2DD 
EA9a 
OOEE 
EAsS 
EBOO 
ED17 
EB1iD 
EB25 
EBSO 
FES1 
0084 
EA54 
Fiac 
OOEA 
0090 
FAE4 
EDIF 
ED4s 
OOSE 
oOSD 
0058 
COSA 
0003 
EFAC 


3707 
3722 
3499 
~231 
2051 
3993 
3998 
-2750 
4048 
3866 
2341 
3855 
4180 
-138 
-1425 
4912 
48978 
-4897 
4156 
2290 
1733 
1908 
“1997 
-106 
1986 
1843 
4196 
-141 
eli2 
3863 
1979 
~612 
1958 
2065 
2559 
2100 
2106 
2141 
4216 
~140 
18976 
~3641 
“2425 
~2426 
4404 
2565 
2584 
~265 
~264 
~263 
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-88 
3119 


3725 
2150 


4075 


2346 


-5624 


~4170 


-4219 
1098 


-5569 
S394 
-1917 


-5002 


4840 
5003 
5424 
5409 


2154 
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OP INP EF SD 3133 3156 -3140 


OPNCOM F404 4101 -4106 

OPNEDT Fii8 -3551 3553 3554 

OPNERR F453 ~4141 

OPNH OOF 1 ~3553 3554 3679 

OPNIN 0004 -113 115 

OPNING OGOC “115 

OPNL 0018 -3554 3677 

OPNOT 0008 ~114 115 

OPNOUT 0002 -2892 

OPNRTN EFSF 3165 -3190 31968 

OPNTMP 0066 “271 4153 4162 4191 4217 4218 4219 

OPOK EFDS 3184 -3226 

OPOUT EFOS 3158 -3194 

OPSYS F1i7B -3629 

OSRAM F2BA 3634 -3831 

OUTCH FSB7 4059 -4308 

OUTCH2 FSFF -4344 4368 4630 

OUTCHA FSBD ~4311 

OUTCHB FSD7 4318 -4321 

OUTCHE FSCA 4313 -4316 4435 

OUTPLT FSEO 4321 -4326 4327 4607 S523 5539 

OVRRUN OO8E -~150 2108 

POPF DOO4 ~718 

POPL DOOoCc ~726 

PIPF DOOS “79 

PIPL DCOD ~72a7 

P2PF DOOS -720 

P2PL DOOE -728 

P3PF D007 ~72i 

PSPL DOOF ~F29 

PACTL D302 ~754 1272 1278 1345 1707 2218 2245 2263 
2634 3147 3207 3291 

PADDLO 0270 -371 1500 

PADDL1 0271 ~372 

PABDL2 0272 -373 

PADDL3 0273 -374 

PADDL4 0274 ~375 1502 

PADDLS 0275 ~376 

PADDLS 0276 “S77 

PADDL.7 0277 -378 

PAGETB FE7S 4179 -S401 

PALFLG 0000 “17 #1647 1653 2483 2488 25398 2541 3168 
3172 3209 3213 3317 33260 3340 3343 

PBCTL D303 “735 1273 1279 1349 1710 1777 2063 2635 

PBPNT 001D -“195 2974 2984 2990 3001 3014 

PBRK EFS8B ~3188 3221 

PBUFSZ OO1E “196 #2955 2988 2998 3046 3082 

PBYTE FO1LO 3119 -3263 

PCOLRO 02C0 “432 1434 

PCOLR1 02C1 ~433 

PCOLR2 02C2 434 


PCOLRS3 02C3 ~435 


PDEVN 
PENH 
PENV 
PHACRI 
PHACRS 
PHCHLO 
PHCLOS 
PHINIT 
PHOPEN 
PHPUT 
PHSTAT 
PHSTLO 
PHWRIT 
PIA 
PIRG 
PIRQGI 
PIRG2 
PIRQ3 
PIRG4 
PIRQ@S 
PIRGH 
PIRGQGL 
PLACRI 
PLACRS 
PLOT 
PLUS 
PLYARG 
PLYEVL 
PMBASE 
PNMI 
PNMI1 
PNMIH 
PNMIL. 
POINT 
POKEY 


POKMSK 


POKTAB 
PORTA 
PORTB 
POTO 
POT1 
POT2 
POTS 
POT4 
POTS 
POTS 
POT? 
POTGO 
PRINTR 


0040 
D40Cc 
D40D 
FC9OF 
FC9D 
EE7F 
EEDC 
EE78 
EEQF 
EF14 
EES1 
EE7D 
EEA7 
D300 
E6F3 
FFDC 
FFFO 
FFCB 
FFEB 
FFBE 
OOESG 


‘OOF 


FCAA 
FCAS 
0050 
ECF8 
OSEO 
DD4O 
D407 
E791 
E799 
O0E7 
0091 
0025 
B200 


0010 


EDDO 
D300 
D301 
D200 
D201 
D202 
D203 
D204 
D205 
D206 
D207 
D20B 
0050 


~2896 
-~746 
-74&7 
-3313 
4425 
2940 
2913 
2918 
2912 
2964 
2916 
—-2939 
2915 
-~7Si 
~1i281 
9782 
—-S795 
3777 
3779 
4082 
1252 
1254 
-5323 
4643 
-1627 
2518 
~433 
-S91 
~742 
-1372 
1373 
1256 
1258 
~105 
~6350 
458 
666 
474 
-183 
2303 
2921 
~7352 
-753 
~6351 
~4$2 
“453 
-654 
~655 
-456 
“697 
~658 
~662 
-123 


3036 
1421 
1419 
5316 
4651 
3002 


~3013 — 


-2932 
2972 
-~3059 
“2954 
2956 
-2982 
732 
1977 
-$787 


-3780 
3786 
-~S7795 
-1577 
~1578 
5326 
4474 


-2520 
634 


1579 
“1375 
“1579 
~1580 


491 
459 
667 
475 
1307 
2329 
2524 
1275 
1276 
1499 


15G1 


1905 


$211 -5312 S524 


3003 


2972 
2957 


733 
1578 


-5793 


1578 


9253 


1580 


1580 


632 
460 
668 
4764 
1316 
2331 
-2499 
1347 
i351 


734 


“S322 


693 
661 
669 
677 
19325 
2372 


1482 


735 


9943 


4354 
462 
470 
478 
1997 
2373 


1489 


435 
4643 
671i 
&79 
i999 
4lis 


456 
464 
672 


2031 
4116 


657 
445 
673 


2033 


PRINTV 
PRIOR 

PRMODE 
PRNBUF 
PRNORG 
PRNSPR 
PRVOPN 
PSIOC 

PTEMP 

PTIMOT 
PTRIGO 
PTRIGI 
PTRIG2 
PTRIGS 
PTRIG4 
PTRIGS 
PTRIGG 
PTRIG7 
PTRLP 

PUTADR 
PUTBC 

PUTCAR 
PUTCHR 
PUTCNT 
PUTDAT 
PUTDTO 
PUTLIN 
PUTMSC 
PUTREC 
PUTSEC 
PUTTXT 
PWRONA 
PWRUP 

PWRUP 1 
RADFLG 
RADON 

RAML.O 


RAMSIZ 
RAMTOP 


RANDOM 
RANGE 
RANGE 1 
RANGE2 
RANGES 
RBLOK 
RBLOKV 
RCI1 
RCTil 
RCI1iA 
RCIiB 


E430 
DOiB 
EFIA 
03CO 
EE78 
0014 
0081 
EFO1 
OO1F 
001C 
027C 
027D 
O27E 
027F 
0280 
0261 
0282 
0283 
ESAC 
EE4D 
EFE43 
OOOB 
OCOB 
EE21 
0080 


EEO! . 


F385 
FCF3 
0009 
0050 
0009 
F3E4 
F125 
F128 
OOFB 
0000 
0004 


O2E4 
0064 


D20A 
FA 
FAB7 
FABB 
FASE 
EFE? 


- Ea7A 


ESA7 
ESBF 
ES74 
ES71 


-58 
-709 
2983 
-533 

-29 

-3097 
~137 
3043 
~197 
-194 
-383 
-384 
-385 
-386 
-387 
-388 
-389 
-390 

-1509 
2827 
2826 

-3408 

~92 
2811 

-2752 
2801 
3735 
4567 

-91 

-2745 

-3406 
4049 
3493 
3548 
-622 
-623 
-170 
3800 
3913 
-451 
~273 
5180 
-661 
4290 
AF69 
4974 
4961 
3130 

-B80 

963 
-994 

936 
-940 


3511 
1430 
3013 
2940 
2875 


849 
~3045 
2782 
2933 
1516 
1513 


1520 
2634 
—-283 1 


886 
-2817 
2809 
-2803 
~3958 
4782 


3943 
4062 
3497 
-3578 


3589 
3801 
3915 
3655 
4070 


4309 
~48975 
~4977 
4963 

3236 

3129 

968 


-943 
944 


3848 


-3069 
2986 
2925 


2985 
3050 


-2862 


~5377 


4076 
3566 


3590 
3804 
3936 
3663 
4133 


4935 


-3241 
3977 
~-973 


2996 


3040 


-4086 
-3576 


3591 
3897 
3939 
3837 
4144 


4957 


3686 


3595S 
3899 
3940 


4207 


-4959 


3596 
390& 


4229 


SS22 


a79S 
3910 


4575 


9534 


3798 
3912 


51644 


RCI2 
RCI3 
RCT4 
RCI4 
RDBAD 
RDBYTE 
RDBONLY 
READ 
RECEIV 
RECVDN 
RECVDS 
RECVEN 
REDGE 
RELONE 
RENAME 
RESET 
RETURI 


RETUR2 
RETURS 
RETURN 
RIRGHI 
RIRGLO 
RMARGN 


RNGER1 
RNGER2 
RNGERR 
RNGOK 
ROWAC 


ROWCRS 


ROWINC 
RRETRN 
RSIRG 

RTCLOK 


Ss 
SAVADR 


SAVIO 
SAVMSC 


SBUFSZ 
SCOLLP 
SCREDT 
SCRENV 
SCRFLG 


ESAC 
E587 
ESC3 
ESB2 
EESi 
F310 
0087 
0052 
EAEG 
0039 
EC4&0 
EC1B 
0027 
EAB1 
0020 
F1iB 
F634 


F621 
FAE1 
EAOD 
00006 
0078 
0053 


FAD8 
FADS 
FAD1 
FAC4 
0070 


0054 


0079 
EBOE 
000A 
0012 


0053 
0068 


0316 
0058 


OO1D 
ESOE 
0045 
E410 
02BB 


974 
981 


-2048 
2070 


~3544 
4057 
-4369 
4320 


1954 
4557 
5283 
4973 
4942 
5481 
4388 
4646 
4887 
5189 
5339 


9413 


1396 


4185 


2590 
4174 


3846 
4444 


986 


2257 
2122 


4060 
4529 
4323 


-186i 


4542 


4976 


4943 
5485 
4407 
4643 
4904 
5215 
9342 


9490 


1398 


4187 


2592 
A241 


4052 
A926 


—998 


4074 
5553 
4447 


4946 


-4988 
5470 
4546 
4702 
A965 


9248 
9489 


2599 


4654 


9162 


4294 


4942 


9474 
4547 
4776 
9093 
3277 
249 1 


3a15 


4656 


9377 


SCRMEM 
SCRNOK 
SCROL1 
SCROL2 
SCROLL 
SDLSTH 
SDLSTL 
SDMCTL 
SECT1 
SECTX 
SEND 
SENDDS 
SENDEN 
SENDEV 
SENDIN 
SER IN 
SEROUT 
SETBSZ 
SETDCB 
SETLOP 
SETTAB 
SETVBL 
SETVBV 
SETVBX 
SEX 
SFH 
SHF AMT 
SHFLOK 
SHIFT1 
SHIFT2 
SHIFTD 
SHIFTU 
SIDWAY 
SIGNON 
SIN 
SIO 
SIOINT 
SIOINV 
SIOORG 
SIOSB 
SIOSPR 
SIOV 
SIRHI 
SIRLO 
SIZEM 
SIZEPO 
SIZEP1 
SIZEP2 
SIZEPS 
SKCTL 
SKRES 
SKSTAT 
SOUNDR 


0093 
FiDB 
FBB7 
FBCA 
FBAC 
0231 
0230 
022F 
F301 
F34C 
EA6B 
EC SF 
EBF2 
E468 
ECB8A 
D20D 
D20D 
EF S34 
EEES6 
ESF7 
FE2D 
ESED 
E45C 
EDB? 
0000 
EF 464 
OO6F 
02BE 
FSBti 
F&i0 
FSAA 
F408 
0053 
F223 
BDS1 
E959 
E944 
E465 
E?44 
FO9S 
0014 
E459? 
OOEB 
OOOF 
DOOC 
BOOS 
DCO? 
DCOA 
DOOB 
D20F 
D20A 
D2OF 
0041 


~156 
3685 
472i 
5149 
4925 
-339 
~338 
-337 
~O3B85 
“3919 
-1940 
1861 
1492 
-74 
1779 
-663 
=6/7 
3074 
271 
-1561 


4621 


1224 
-70 
2215 
“3415 
~3143 
-277 
~428 
4299 
4348 
~4298 
~4347 
~1624 
3485 
-400 
1686 
1489 
-73 
-27 
3242 
~2727 
-&9 
-2423 
~2424 
~OF74 
-490 
-4F1 
~OF2 
~493 
-&79 
—-&78 
~645 
-238 


4748 
-3687 
~3164 

$172 
“3159 

1423 

1425 

1427 

4003 

3924 

2225 

19644 

1943 

1691 

1807 

2114 

19Se2 

3078 

3004 

1562 

9685 

1226 

1225 

2242 

3675 


4298 
4092 
~4302 
4351 
4301 
4350 


-3733 


-~1726 
-1706 
1688 
1584 
“3361 


1685 


2424 


1716 
2097 
1459 
1715 


3688 
S177 
~5174 


4253 
411i 


2443 
-2370 
2207 
3265 
—-2436 
2131 
1992 
-3082 
-3634 


-1556 
2660 
2253 
3959 


4347 
4493 


3851 
1702 
3394 


2621 


2300 
2326 
1469 
2340 


3690 
91681 


4255 4266 4268 
4285 4286 


2632 
~2284 


2010 


3178 3217 
2447 ~2652 


4843 
4498 4503 4520 


2942 3005 3984 


2324 


2096 2568 2588 2611 


2613 


SPACE 
SPECIA 
SPECIL 
SPECL 
SGR 
SRETRN 
SRSTA 
SRTIM2 
SRTIMR 
SRTIRO 
SRTIR1 
SRTIR2 
SSFLAG 
SSKCTL 
STACK 
STACKP 
STATC 
STATIS 
STATU 
STATUS 


STATVH 
STATVL 
STICKO 
STICKI 
STICKe2 
STICKS 
STIMER 
STLOOP 
STORE 


STOREI 
STRBEG 
STRERR 
STRIGO 
STRIGI 
STRIG2 
STRIGS 
STRL 

STROK 
STTMOT 
SUBBFL 
SUBEND 
SUB TMP 
SUCCES 


SUSUAL 
SV7H 
SV7L 
SWAP 
SWAP 1 
SWAPS 


0020 
EF 4B 
OO0E 
F23F 
BEB1 
EB34 
0040 
0006 
022B 
EB9B 
EBCi 
EBE? 
O2FF 
0232 
0000 
0318 
0033 
OCOD 
FO28 
0030 


0002 
OOEA 
0278 
0279 
027A 
0278 
D209 
E877 
FOL7 


F91iD 
FCSC 
F942 
0284 
0285 
0286 
0287 
E890 
F946 
EC7S 
E&77 
FA7A 
O29E 
oool 


EB38 
OOE8 
0073 
FCB3 
FCC2 
FCD7 


-2899 
3119 
-95 
3582 
~603 
2116 
-3103 
-1219 
-333 
2211 
2238 
2240 
-473 
-340 
0 
~507 
-2748 
-94 
3119 
~219 
1927 
-2736 
-2737 
-379 
~380 
-3e1 
-382 
-475 
~1482 
4190 
4236 
4267 
-4748 
4545 
4764 
-391 
-392 
-393 
-394 
-1497 
4746 
1815 
998 
-4939 
~414 
-134 
3226 
-2124 
-1523 
-1524 
4384 
-5339 
5337 


2995 
—3145 
846 
-3781 


-21e21 
3377 
1475 
1447 

~2214 

~2241 

“2265 
1338 
1714 


1727 
2810 


—-3280 
1846 
1941 
2737 
2612 
1487 


1494 
4204 
4238 
4249 


-5261 
~4768 
1498 


1504 
4734 
2252 
1059 
S493 
4732 

898 
3299 
2148 
1524 


4398 
9346 
5350 


848 
2156 


1472 


4326 
2285 


2640 
2829 


1849 
2060 
2814 


1491 


4210 
4242 
-4745 


4763 
-2396 
-1138 

S521 

4757 

1850 

3266 

2162 


4418 


14764 


9783 
2299 


2998 


1864 
2074 


1509 


4212 
4244 


4767 


1526 


$785 
2321 


3042 


1894 
21023 


4214 
4247 


-~4770 


S794 


2323 


3871 


ivil 
2109 


4222 
4249 


2612 


191s 
2119 


4232 
42351 


1917 
2638 


4234 
4257 


2089 2993 3016 
4112 4370 4981 


4434 4448 -5333 


FCB9 
007B 
0086 
E706 
E71B 
E762 
E76&F 
E77A 
E7@F 
E790 
E78B 
E7BA 
E7D6 
EVES 
E832 
EaC3 
E873 
E844 
E834 
E7AE 
E45F 
E857 
F810 
F823 
FE2A 
O2A3 
FOES 
OOOE 
OOEA 
OOCF 
023E 
0312 
0314 
O315 
0002 
OOSE 
030C 
0310 
0317 
EBAS 
EBCB 
OOBA 
0293 
0050 
02B9 
O2A1 
02B8 
029C 
0066 
0002 
0001 
EBOA 
ED44 


4995 
-285 
—3104 
1243 
1304 
1322 
1346 
1350 
1235 
1234 
1358 
1394 
1410 
1417 
1446 
1471 
1468 
1453 
-1449 
1227 
-71 
1461 
~4609 
44612 
4616 
~419 
-~3510 
~3538 
~2427 
-—2428 
-354 
-502 
-$03 
~504 
-1667 
-1668 
—-497 
-500 
-506 
—-2220 
-2247 
~146 
~409 
“254 
~424 
~417 
-423 
-412 
~4034 
~G1i13 
~3114 
2069 
2564 


$333 -5335 
4121 4907 
3380 
—-1301 
—-1310 
“1343 
—1349 
-1353 
1236 1237 
—1365 
~1362 
1397 -1399 
-141i2 
~1419 © 
-1448 
“1525 
1473 -1480 
-1456 
1457 
1247 -1393 
1464 -1467 
4619 S675 
4415 -4617 
~-4&620 
4125 5041 
3538 3641 
3640 
2428 
1667 1668 
2478 2496 
2578 2596 
1668 1884 
1860 
2472 2474 
2468 2469 
2068 2220 
2221 
2248 
1918 2073 
4119 
4352 4356 
4818 4827 
$314 $323 
4685 4689 
3196 
3163 
“2073 2586 


-2585 


4993 


1240 


1523 


5043 


1901 


2477 
2471 
2247 


3097 


4831 


2096 


S22i 


1241 


1524 


5049 


2481 
2475 
2274 


3100 


3099 


9347 


1242 


1527 


S050 


2574 
2479 
2564 


3109 


S349 5366 
-1364 
S058 
2575 
25983 2662 
211i S1iis 


TRAMS Z 


TRIGO 
TRIGI 
TRIG2 
TRIGS 
TRNRCD 
TSTAT 
TSTCT1I 
TSTCT2 
TSTCTL 
TSTDAT 
TWICE 
TXTCOL 
TXTMSC 
TXTOLD 
TXTROW 
UNLOCK 
UPDNCM 
USAREA 
VBATRA 
VBREAK 
VBWALT 
VCOUNT 
VCTABL 
VDELAY 
VDSLST 
VECTBL 
VIMIRQ 
VINTER 
VKEYBD 
VPRCED 
VSCROL 
VSERIN 
VSEROC 
VSEROR 
VTIMR1 
VTIMR2 
YTIMR4 
VVBLKD 
VYBLKI 
WALT 
WAITER 
WALTTM 
WARMST 
WARMSV 
WATCOM 
WCLL 
WCILA 
WCILB 
WCI2 
WC13 
WC14 


0006 


DO1O 
DOI 
D012 
BO13 
0089 
0319 
FCF 
FC9C 
FC8D 
0007 
EE4F 
0291 
0294 
0296 
0290 
0024 
F787 
0480 
E7C8 
0206 
F496 
D40B 
E480 
DO1iC 
0200 
E400 
0216 
0204 
0208 
0202 
D405 
020A 
O020E 
020C 
0210 
0212 
0214 
0224 
0222 
EALA 
EC9B 
EF7C 
0008 
E474 
E?D7 
E4605 
ESD4 
ESDi 
E&0A 
ESES 
ESEB 


-1714 
3805 
-730 
~731 
-732 
-733 
~145 
-508 

-5299 
5301 
4432 
-172 

~2836 
-408 
-410 
-4it 

407 
-104 

-4544 
-548 
1402 
-314 

-4175 
-745 

~24 
-710 
-31i1 

-23 
-322 
-313 
-315 
-312 
-7414 
-314 
-318 
-317 
-319 
-320 
~321 
-329 
-328 

-1876 
1820 

-3179 
-175 

-78 
1795 
1034 
1005 

-1009 

-1050 
1018 
1024 


3597 
3808 
1497 


994 
1845 
5305 

-5306 
4524 
3653 
2840 
4283 
4135 


4281 
4551 


~14C6 
1361 
4177 
2572 
1232 


1232 


1281 
1352 
1293 
1348 


1299 
1297 
1298 
1296 
1295 
1294 
iS2e2 
1385 
2449 
“2447 
3180 
3578 
1379 
“1815 
1039 
-1012 
1013 


~1024 
~1027 


3654 
3836 


1928 


~5298 
3660 


4137 


5341 


2598 
1694 


1374 


4081 


1309 


3584 
3487 


-1044 


1045 


3668 3697 3700 3715 3797 


36978 3703 3721 


S344 


4175 
3630 4081 


1494 


3588 3862 3989 


LOL ener | 


WCIS 
WDLR 
WF AK 
WFAK 1 
WFL 
WIRGHI 
WIRGLO 
WMODE 
WOK 
WRITE 
WRITEC 
WRONLY 
WSIOSB 
WSIRG 
WSYNC 
WTLR 
XBOOT 
XITVBL 
XITVBYV 
XMTDON 
XXIT 
ZERIT 
ZERORM 
ZIOCB 
ZOSRAM 
ZOSRM2 
ZOSRM3 
ZTBUF 
ZTEMP 1 
ZTEMPS 
ZTEMP4 


1028 
3220 
3337 
3350 
~3324 
~1459 
-1654 
397 
~1901 
—-1617 
~2898 
—139 
3272 
~1656 
-744 
3294 
3926 
1228 
~72 
won? 
1413 
~2378 
-23587 
=-199 
3585 
~3612 
~3617 
-3301 
~618 
~420 
~619 


1041 
3223 
~3350 
“3353 
3395 
2214 
2213 
3161 


2807 
3069 
939 
3297 
2209 
1540 
—~3299 
-3928 
1248 


1948 
“1418 
2361 


~3610 
3615 
3619 
3303 


1052 


3191 


3305 


9357 


1418 


1961 


“1059 


3195 


~3389 


“1571 


2029 


3286 
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i. INTRODUCTION 


The ATARI (R) 800™™ and ATARI 400™™ Personal Computer Systems © 

contain a 6502 microprocessor, 4 1/0 chips, operating system ROM, expandable 
RAM, and several MSI chips for address decoding and data bus buffering. 

This manual is primarily intended to describe the 4 I/O chips in sufficent 
detail to allow experienced programmers to create assembly language programs, 
such as video games. All four Input/Output chips are controlled by the 
microprocessor by writing directly into their registers which are decoded 

to exist in microprocessor memory space just as RAM does. These I/O chips 
can also be interrogated by the microprocessor by reading similar registers. 


Many registers are write only and cannot be read after they are 
written. In some cases, reading from the same address gives the value 
contained in a separate read only register. Some write only registers are 
strobes. No data bits are needed in this case since the presence of the 
address on the bus is what triggers the requested action. The usual 
convention is to use the STA (Store Accumulator) instruction for such 
registers. For example, STA WSYNC performs the wait for Sync function. 
STX (Store X) or STY (Store Y) would work just as well. In BASIC, a POKE 
could be used (the data could be anything). Reading a register is accomp- 
lished by using any of the load instructions (LDA, LDX etc.). In BASIC 
‘a PEEK would be usede When the hardware register names are defined in an 
equate list, the programmer can refer to the registers by name rather than 
using the addresses directly. 


It is really not necessary for the programmer to know which 
I/O functions are performed by which of the 4 chips, however it 
does help in learning these functions. 


This manual should be used in conjunction with the Operating 
System (OS) Manual, a 6502 programming manual, and the ATARI 400/800 
Basic Reference Manual. 


CHIP NAME FUNCTION 
ANTIC DMA(Direct Memory Access) control 


NMI (Non—Maskable Interrupt) control 
Vertical and Horizontal fine scrolling 
Light pen position registers 

Vertical line counter 

WSYNC (wait for horizontal sync) 


CTIA Priority control (display of overlapping objects) 
Color-Lumimance control (colors and brightness assigned 
to all objects including DMA objects from ANTIC) 
PLAYER-MISSILE objects (4 players and 4 missiles) 

Graphics registers 
Size control 
Horizontal position control 
Collision detection between all objects 
Switches and triggers (miscellaneous 1/0 functions) 


CHIP NAME FUNCTION 


POKEY Keyboard scan and control 
Serial communications port (bidirectional) 
Pot scan (digitizes position of 8 independent pots) 
Audio generation (4 channels) 
Timers 
IRQ (maskable interrupt) control from peripherals 
Random number generator 


PIA Controller (Joystick) jacks read or write 
Peripheral control and interrupt lines 
IRQ (maskable) interrupt control from peripherals 


Section II describes the hardware in some detail, including the 
various graphics modes. Section III lists the hardware registers one at a 
time, describing what each bit is used for. It is organized by functional 
groups (interrupts, graphics, audio, etc.). Section IV contains a sample 
display program. Section V contains various figures and block diagrams of 
the systeme Sections VI and VII list the hardware registers in address 
order and alphabetical order. Section VII includes hex and decimal 
addresses, the OS shadow registers and the page numbers where more infor- 
mation can be found. 
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I. DESCRIPTION .OF HARDWARE 


A. ANTIC AND CTIA 


TV Display: The ANTIC and CTIA chips generate the television 
display at the rate of 60 frames per second on the NTSC (US) system. 
The PAL (European) system is different and is described in the section 
on NTSC vs PAL. Each frame consists of 262 horizontal TV lines and each 
line is made up of 228 color clocks, as shown in figure VI-3. The 6502 
microprocessor runs at 1.79 MHz.- This rate was chosen so that one 
machine cycle is equivalent in length to two color clocks. One clock 
is approximately equal in width to two TV lines. 


In any graphics mode, the display is divided up into small squares 
or rectangles called pixels (picture elements). The highest resolution 
graphics mode has a pixel size of 1/2 color clock by 1 TV line. A 
sample display list is given in section IV. 


The current TV line may be determined by reading the vertical counter 
(VCOUNT). This register gives the line count divided by 2. There are 262 
lines per frame so VCOUNT runs from 0 to 130 (0 to 155 on the PAL system). 
The O point occurs near the end of vertical blank (see figure VI.5). 
Vertical blank (VBLANK) is the time during which the electron beam returns 
back to the top of the screen in preparation for the next frame. The 
Atari 800 does not do interlacing, so each frame is identical unless 
the program which is being executed changes the display. Vertical sync 
(VSYNC) occurs during the fourth through sixth lines of vertical blank 
(VCOUNT = hex 7D through 7F). This tells the TV set where each frame 
starts. After VSYNC, there are 16 more lines of VBLANK for a total of 22 
lines of VBLANK. The display list jump and wait instruction (to be 
described later) causes the display list graphics to start at the end of 
VBLANK. 


Operating System (0S): The ATARI 400/800 comes with a 10K Operating 
System (OS) in ROM. The OS affects some of the hardware registers, so 
it will be mentioned from time to time in this manual. Refer to the OS 
manual for more details. The OS descriptions in this manual apply to the 
version that was being distributed when this manual was written. 


The OS supports most of the hardware graphics modes (BASICS, GRAPHICS, 
PLOT, and DRAWTO commands). The OS always displays 24 background lines after 
the end of vertical blank. This convention is used at Atari to compensate 
for television sets which overscan. Most TV’s are designed so that the 
edges of the picture are cut off. This is fine for ordinary broadcasts, 
but with a computer it is essential for all important information to be 
displayed on the screen. It is fairly common for four to eight color 
clocks at the right or left edge of the picture to overscan. A TV set 
that has excessive overscan may have to readjusted to obtain a satisfactory 
display. 
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The OS uses 192 TV lines for its display and devotes the remaining 
24 lines to overscan. It uses the standard display width of 160 color 
clocks. The hardware will allow displays of any length, but it is recom- 
mended that the standards be followed. The exception might be a border 
or other information which is merely decorative and not essential to use 
of the program. 


OS Shadowing: Since many of the hardware registers are write-only 
and cannot be read the OS has a mumber of "shadow registers" in RAM. 
Every TV frame during vertical blank the OS takes the values in some of 
its shadow registers, and writes them out to the corresponding hardware 
register. The OS does attract color shifting on all of the color registers 
if ATRACT (on OS register) is negative. This is to prevent damage to the 
TV screen phosphors which can occur if the brightness is turned up too high 
and the same high-luminance display is left on for a long time. The OS also 
reads the joysticks and other controllers during vertical blank and stores 
the results in shadow registers, so that user programs do not have to include 
code to unpack the data. There are a few interrupt-related registers which 
the OS changes or reads during interrupt processing. Programs usually access 
the OS shadow registers instead of accessing the hardware directly. However, 
the OS shadowing can be disabled by changing the vertical blank and interrupt 
vectors (see OS manual). 


WSYNC: In addition to a Vertical Blank Interrupt, which allows the 
Microprocessor to synchronize to the vertical TV display, this system also 
provides a Wait for Horizontal Sync (WSYNC) command that allows the 
microprocessor to synchronize itself to the TV horizontal line rate. This 
sync takes effect when the processor writes to an I/O location called 
WSYNC, whenever it desires horizontal synchronization. Writing to this 
address sets a latch which pulls to zero a pin on the microprocessor 
called READY. When READY goes to zero the microprocessor stops and waits. 
The latch is automatically reset (returning READY true) at the beginning 
of the next horizontal blank interval, releasing the microprocessor to 
resume program execution. 


Object DMA (Direct Memory Access): The primary function of the Antic 


chip is to fetch data from memory (independent of the microprocessor) for 
display on the TV screen. It does this with a technique called "Direct 
Memory Access" or DMA. It requests the use of the memory address and data 
bus by sending a signal called HALT to the microprocessor, causing the 
processor to become "TRI-STATE" (open circuit) all during the next computer 
cycle. The ANTIC chip then takes over the address bus and reads any data 

it wishes from memory. Another name for this type of DMA is "cycle stealing". 
Once initiated, this DMA is completely and automatically controlled by the 
Antic chip without need for futher microprocessor intervention. 


There are two types of DMA: Playfield and Player-Missile (see Figure 
II.2). The playfield DMA control circuit on the Antic chip resembles a 
small dumb microprocessor. By halting the main microprocessor it can 
fetch its own instructions from memory (the display list) addressed by its 
program counter(display list pointer). Each instruction defines the type 
(alpha character or memory map), and the resolution (size of bits on the 


screen), and the location of the data in memory which is to be displayed 
on the next group of lines. 
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In order to begin this DMA the main microprocessor must store a 
display list of instructions in memory, store data to be displayed in 
memory, tell the ANTIC where the display list is (initialize the display 
list pointer) and enable the DMA control flags on the ANTIC (DMACTL 
register). 


In addition to the playfield DMA described above, the ANTIC 
chip similtaneously controls another DMA channel. This type of DMA 
addresses PLAYER-MISSILE graphics data stored in memory and passes the 
graphics data on to the CTIA chip graphics registers. This type of DMA 
(if enabled) occurs automatically, interspersed with the playfield DMA 
described previously. This PLAYER-MISSILE DMA has no display list or 
instructions, and is therefore much simpler than the PLAYFIELD DMA. 


In addition to the two types of display DMA, the ANTIC chip also 
generates DMA addresses for the refresh of the dynamic memory RAM used 
in this system. This is also completely automatic and need be consider- 
ed by the programmer only if he is concerned with real-time programming 
where an exact count of the computer cycles is important. 


Color-luminance: A color-luminance register is used on the CTIA chip 
for each Player-Missile and Playfield type. Each color-lum register is 
loaded by the microprocessor with a code representing the desired color 
and luminance of its corresponding Player-Missile or Playfield type. As 
the serial data passes through the CTIA chip it is "impressed" with the 
color and luminance values contained in these registers, before being sent 
to the TV display. In areas of the screen where there are no objects the 
background color (COLBK) is displayed. The CTIA also does collision 
detection (to be described later). 


Priority: When moving objects, such as players and missiles, 
overlap on the TV screen (with each other or with Playfield) a decision 
must be made as to which object shows in front of the other. Objects 
which appear to pass in front of others are said to have Priority over 
them. Priority is assigned to all objects by the CTIA chip before the 
serial data from each object is combined with the other objects and sent 
to the TV screen. 


The priority of objects can be controlled by the microprocessor by 
writing into the control register PRIOR. The functions of the bits in 
this register are given in the table in the PRIOR register description in 
section III. 


Players and Missiles: The players and missiles are small objects 
which can be moved quickly in the horizontal direction by changing their 
position registers. They are called players and missiles because they 
were originally designed to be used in games for objects such as airplanes 
and bullets. However, there are many other possible applications for 
them. The four player-missile color registers, in conjunction with the 
four playfield color registers and the background color register, make 
it possible to display 9 different colors at the same time. 
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OBJECTS (no objects = background) 


ae PLAYFTELD 
4 _ PLAYERS 4 MISSILES MEMORY_ MAP CHARACTERS 


controlled by 
Display list 
instructions 


(DMACTL ) 


V_--~Y’ Player 
Missile 
DMA 


Enable 


Playfield 
DMA Enable 


MICRO 
PROCESSOR 


MEMORY 


Figure II.2 OBJECT DISPLAY SOURCES 
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There are a total of four players and four missiles. The four 
missiles may be grouped together and used as a 5th player. These 
objects are positioned horizontally by 8 horizontal position registers 
(HPOS (X))- These registers may be reloaded at any time by the proces- 
sor, allowing an object to be replicated many times across a horizontal 
TV line. 


The shape of a player-missile is determined by the data in its 
graphics register (GRAF (X))- Players have independent 8 bit graphics 
registers. The four missiles have 2 bit registers (located within one 
address). These registers may also be reloaded at any time by the 
processor, although they are usually changed during horizontal blank 
time. The data in each graphics register is placed on the display 
whenever the horizontal sync counter equals the corresponding horizon- 
tal position register. The same data will be displayed every line unless 
the graphic registers are reloaded with new data. 


The player-missile graphic registers may be reloaded by the micro- 
processor (GRAF (X)), or automatically from memory with direct memory 
access (DMA) (see figure II.3). The programmer must place the object 
graphics in memory, write the player-missile base address (PMBASE), and 
enable player-missile DMA (DMACTL, GRACTL). The transfer of object 
graphics from memory to display is then fully automatic. 


PMBASE specifies the most significant byte (MSB) of the address of 
the player-missile graphics. The location of the graphics for each 
object is determined by adding an offset to PMBASE *256 (decimal). The 
bytes between the base address and the missile data are not used by 
Antic, so they are available to the programmer. 


Only the five most significant bits of PMBASE are used with 
single-line resolution and the six most significant bits are used 
with two-line resolution. This means that the location of the graphics 
in memory is restricted to certain page boundaries. Two-line resolu- 
tion means that each byte of data is repeated for two lines. (see 
DMACTL, bit 4). 640 (decimal) bytes (5X128) are required for two-line 
resolution and 1280 bytes (5x256) for one-line resolution. 


Each byte in the player graphics area represents eight pixels which 
are to be displayed on the corresponding line(s) of the TV screen. A 
1 indicates that the player’s color-lum is to be displayed in that pixel. 
The graphics may be anything, not just rectangles like the ones in figure 
II.3. The player graphics may fill the entire height of the screen or 
they may be only a couple of lines high if the rest of the display data is 
all 0’s. Each byte in the missile display also represents eight pixels, 
two pixels for each missile. Each pixel may be 1, 2, or 4 color clocks, 
and is determined by the SIZE registers. 


Playfield: Playfield is always generated by DMA. There are four 
playfields, each identified by its own color-lum register and collision 
detection. Playfield is generated by two different DMA techniques: 
memory map and character. Both methods provide lists of instructions in 
memory, independent of the player-missile generation. 
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Player-Missile Base Address (PMBASE) = MSB of address. 


Resolution is controlled by bit 4 of DMACTL. 


PMBASE*100 (hex) 


ADDRESS OFFSET 
Two-line One-line 
resolution resolution 
(hex) (hex) 
. Missile TV SCREEN 
' er 
+180 +300 Numb = m — : 
a“ | 
° Be a ee ae ! 
7 m= |) 
+200 +400 | | MO my | 
| a | Pl | 
PO | P2 lan | 
| wi ML | 
+280 +400 i Sha os HELP ON M3 | 
soereer | 
Pl | | 
+300 +600 | | 
acer | | 
P2 | | Horizontal position 
— “for each object is set 
+380 +700 | | independently by 8 
—_——P_ | | horizontal position 
P3 i | registers. 
+400 +800 
Each section of memory maps directly 
Player-Missile onto total height of TV screen. 
Vertical screen Object vertical position is determined 
map in memory only by its location in its section 
of memory- One byte of memory equals 
1 or 2 television lines vertically. 
Figure II.2 PLAYER-=MISSILE DMA 
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Unlike players and missiles, there are no horizontal position registers 
for playfield. Each player can only have one byte of display per line. 
Playfield, on the other hand, may require up to 48 bytes per line because 
it can fill the entire width of the screen. 


There are three different playfield widths: narrow (128 color 
clocks), standard (160 color clocks), and wide (192 color clocks). 
The width is selected by storing into DMACTL. The advantage of a narrower 
width is that less RAM is required and fewer machine cycles are stolen for 
DMA. The OS graphics modes use the standard screen width. 


Display List: The display list is a sequence of display instructions 
stored in memory. These instructions are either one (1) byte or three (3) 
bytes long. The display list can be considered a display program, and the 
Display List Counter that fetches these instructions can be thought of as 
a display program counter. (10 bit counter plus 6 bit base register.) 


The display list counter can be initialized by writing to DLISTH and 
DLISTL. (or OS shadow registers SDLSTH and SDLSTL). Once initialized 
this counter value is used to address the display list, fetch the instruc- 
tion, display one (1) to sixteen (16) lines of data on the TV screen, 
increment the Display List Counter, fetch the next display instruction, 
and so on automatically without microprocessor control (see DLISTL and 
DLISTH). DLISTL and DLISTH should be altered only during vertical blank 
or when DMA is disabled (see DMACTL). 


Each instruction defines the type (alpha character or memory map) and 
the resolution (size of bits on screen) and the location of data in memory 
to be displayed for a group (1 to 16) of lines. Each group of lines is 
called a display block. 

THE DISPLAY LIST CANNOT CROSS A 1K BYTE MEMORY BOUNDARY UNLESS 
A JUMP INSTRUCTION IS USED. 


DLISTH (MSB DLISTL (LSB 


ct | foto td Me air Se he 
D7 [D6 [D5 {D4 [D3 [D2 [D1 {DO D7 1D6 |D5 |D4 |D3 |D2 |D1 |DO 


15 114 [13 {12 {11 
Fixed (6 bits) Counter (10 bits) 


DISPLAY LIST COUNTER 
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Display Instruction Format: Each instruction consists of either an 
opcode only, or of an opcode followed by two (2) bytes of operand. 


SaaS Single Byte Display Instruction 


----Triple Byte Display Instruction 


The opcode is always fetched first and placed in the Instruction 
Register. This opcode defines the type of instruction (1 or 3 bytes) 
and will cause two more bytes to be fetched if needed. If fetched, 
these next two (2) bytes will be placed in the Memory Scan Counter, 
or in the Display List Counter (if the instruction is a Jump). 


Display Instruction Register (IR): This register is loaded with the 


opcode of the current display list instruction. It cannot be accessed 
directly by the programmer. There are three basic types of display list 


instructions: 


Blank 
(1-byte) 


Jump 
(3-bytes) 


Display 
(1 or 3 bytes) 


blank, jump, and display. 


D7|D6|D5}D4{ 0} 0] 0} 0 


This instruction is used to create 1 to 8 blank lines on the 
display (blackground color). 


D7 1 = display list instruction interrupt 
D6 -D4 #£0O-7 = 1-8 blank lines 
D3 -DO O- = blank 


D7|D6| X| xX] O} O} O} 1 


This instruction is used to reload the Display List Counter. 
The next two bytes specify the address to be loaded (LSB first). 


D7 1 = display list instruction interrupt 
D6 0 = jump (creates one blank line on display) 
1 = jump and wait until end of next vertical blank 
D5-D4 X = don’t care 
D3-D0 1 = jump 


D7 [D6[D5|D4{D3[D2|D1/D0 


This instruction specifies the type of display for the next 
display block. 


D7 1 = display list instruction interrupt 
D6 0 = 1 byte instruction 
= 3 byte instruction (reload Memory Scan Counter 
using address in next two bytes, LSB first). 
1 = vertical scroll enable 
D4 1 = horizontal scroll enable 
F = display mode (memory or character map - 
see following pages). 


— 
| 
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HSCROL XX XX XX XX XX XX XX XX Horizontal Scrolling 


VSCROL XX | XX XX | XX XX | XX XX | XX Vertical Scrolling 
LD MEM SCAN XX [XX |XX| XX XX |XX |XX] XxX Load memory scan (3 byte) 
INST INTERRUPT XX|XX/] XX] XX| XX] XX] XX | XX Displa instruction interrupt 
fee de Ae a le le de fee 
BLK 1 100] | | | | | | 180 | | | | | | | | Blank 1 line 
wo ie 110} | | | | ft | t90} FT FT tot t tf Blank 2 lines 
"3-7 | | | | | | | | | | | | | | | | | Blank 3 thru 7 lines 
" 8 P7Or ot i ie Sp ud ee AOR oR cap th. ie dae Blank 8 lines 
IMP Ol] | | | | | | 81] | | | | | | | Jump (3 byte instruction) 
JVB |41| | | | | | | cl | | | | | | | Jump & wait for Vert. Blank 
CHR (40,2,8) 1021/12]22]32]42|52]62|72]82|92|/A2|B2]c2|D2|E2|F2| (also 3 byte) 
"  §(40,2,10) 1031131231331431531[63173/83/|93|A3|/B3|/C3/D3/E3|]F3] 
" (40,4, 8) LO4/14[241/34144]/54]64[/74184/94[A4|B4([C4|D4|E4|F4] Character Mode 
" (40,4, 16) fO5]151251/351/451/55]651/75]1/85/95]/A5]B5{/C5|D5|/ES5I]F5| Instructions 
Ms 4520.43. 558) 106]16|26]36|46]56|66|76|86([96/A6|B6|C6|D6|E6|F6| 
C205 5 bs) LO7{17/27/37147/571/67177187/97/|A7|B7(C7ID7IE7IF7] 
MAP (40,4, 8) 108118]28]38]48]58168|/78|/88|/98{A8|B8|C8|D8|E8|F8] 
"  -§(80,2,4) 109119129139/49159|69([79|/89|99|A9|BOICOIDIIJE9|F9I] 
" §(80,4,4) [OA{IA]2A]3A]4A|5A|6A[7A|8A|9A][AA|BA|CA|DA]|EA]|FA| 
" (160,2,2) |}OB|1B{2B]3B]4B|5B|6B|7B|8B|9B|AB|BB|CB|DB|EB|FB| Memory Map Mode 
" (160,2,1) Joc|1ic|]2c|3c|4c|5c|6c|7c|8c|9C|AC|BC|CC|DC|EC]|FC| Instructions 
" (160, 4,2) lOD|1D|/2D]3D|4D|5D]/6D|7D|8D]9D|AD|BD|CD|DD]ED|FD| 
" (160,4,1) [OEJ1E|2E]3E|4E/5E|/6E|7E|8E|9E|AE|BE|CE|DE|EE|FE| 
" (320,2,1) JOF[IFI2F(3F/4F(5FI/6F|7F|8F|9FIAF|BF([CF|DFIEF|FF | 


ee 
} | f Number of TV lines per cell 
| Number of Colors (Background + Playfield types) 
| Number of Horizontal cells (standard width screen) 


Figure I1I.3 DISPLAY INSTRUCTION OPCODES 
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Bit 7 of a display list instruction can be set to create a display 
list interrupt if bit 7 of NMIEN is set. The display list interrupt code 
can change the colors or graphics during the middle of the TV display. 

The type of interrupt is determined by checking NMIST. NMIRES clears 
NMIST. The current OS will vector through VDSLST (Hex 200 and 201) to 
the user’s display list interrupt routine. See the OS manual for progranm- 
ming details. . 


Bits 5 and 4 of a display type of display list instructions are used 
to enable vertical and horizontal scrolling. The amount of scrolling 
depends on the values in the VSCROL and HSCROL registers (to be described 
later). 


Memory Scan Counter: This counter is not directly accessible by the 
programmer. Jt is loaded with the value in the last 2 bytes of a 3 byte 
(non-Jump) instruction. 


This counter points to the location (address) in memory of data to be 
directly displayed (memory map display) or to the location of character 
name strings to be indirectly displayed (character display). 


A single byte instruction does not reload this counter. This implies 
a continuation in memory of data to be displayed from that displayed by 
the previous instruction. Since this counter really consists of 4 bits of 
register and 12 of actual counter, a continuous memory block cannot cross 
4K byte memory boundaries, unless the counter is repositioned with a 3 
byte Load Memory Scan Counter instruction. 


MSB third byte of 3 byte LSB Second byte of 3 
byte instruction byte instruction 


15] 14{ 13] 12 
Fixed (4 bits) Counter (12 bits) 


Memory Map Display Instructions: Data in memory (addressed by the 
Memory Scan Counter) is displayed directly when executing a memory (bit) 


map display instruction. As data is being displayed it is also stored in 
a shift register so that it can be redisplayed for as many TV lines as 
required by the instruction. 
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Memory Scan Counter 
Addresses each byte 
Memory 


One line worth of memory is 

loaded into the shift register 

Shift \ e 
Register 


Shift register data is displayed for four TV scan lines in this example. 


In Instruction Register (IR) display modes 8 through F, one or two 
bits of memory are used to specify what is to be displayed on each pixel 
of the screen. Pixel sizes range from 1/2 clock by 1 TV line to 4 clocks 
by 8 TV lines. The OS and BASIC support most of these graphics modes 
(BASIC GRAPHICS command). Two modes, C and E, are not supported by the 


OS. These modes have rectangular pixels, which are approximately twice as 
wide as they are high. 


In IR mode F, only one color (COLPF2) can be displayed. Two different 
luminances are available. If a bit is a zero, then the luminance of the 
corresponding pixel comes from COLPF2. If the bit is a one, them the 
luminance is determined by the contents of COLPFl (abbreviated to PFl). 


In IR modes 9,B, and C, two different colors can be displayed. A 
zero indicates background color and a one indicates PFO color. The 
difference between the various modes is in the size of the pixels. 


In IR modes 8,A,D, and E, two bits are used to specify the color 
of each pixel. This allows four different colors to be displayed. 


However, only four pixels can be packed into each byte, instead of eight 
as in the previous mcdes. The bit assignments are shown below. 


SHIFT REGISTER 1 o{7 6 


2 bits form 
one pixel 
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Memory Map Display Modes 


fos | {Colors |Pixels|Bytes|Scan |Color | | Bit | | 
| and |Inst.] per | per | per |Lines|Clocks|Bits eae ee | 
|BASIC|Reg. | Mode | Std. |Std. | per | per |per in | Reg. | 
Medes HEX | | Line | Ling Pine} pixel Piso) [Pte [Select S| 
| 00 | BAK 
| 3 | 8 : 4 | 40 | 10 ! 8 | 4 ! 2 | 01 | PFO | 
| | | | | | | | | 10 | PFI | 
| | | | | | | | [| 11 | PF2 | 
| | | | | | | | | | | 
|; 4 | 9 | 2 | so | 10] 4 | 2 | 1 [| O | BAK | 
| | | | | | | | | 1 | PFO | 
EEE SETAE Oe RE AEH PERT RTE ITS Lae SEN LPR eee 
| | | | | | | | | 00 | BAK | 
1} 5 | A 4 | so | 20] 4 | 2 | 2 | 01 | PFO | 
| | | | | | | | | 10 | PFL | 
| | | | | | | [| 11 | PF2 | 
| | | | | | | | | | | 
; 6 | B 2 | 160 | 20] 2 [{ 1 | 1 | O | BAK | 
| | | | | | | | | 1 | PFO | 
Cereal AIT] DORON ERRORS MEME MERS CRS) CNET ERENCE | Nem eres 
| | | | | | | | | | | 
} - {| c | 2 } 160 | 20] 1 [| 1 ! 1 {| O | BAK | 
| | | | | | | | | 1 | PFO | 
SERTE) URCIRESY tae DRENEN | LORECE SES USERS SERETEON SPR NEEL MC Meeen) (haere meee Cements 
| | | | | | | | | 00 | BAK | 
| 7 | D = 4 |} 160 | 40 | 2 {| 1 | 2 | 01 | PFO | 
| | | | | | | | | 10 | PFl | 
| | | | | | | | {| 11 | PF2 | 
| | | | | | | | | oO | BAK | 
| - | —E | 4&4 |160 | 40] 1 | 2 | 2 [| OL | PFO | 
| | | | | | | | 10 | PF1 | 
| | | ae | | | [| 11 | PF2 | 
| | | | | | | | | | | 
| 8 | F | 1% [320 [| 4o}] 1 | % | 1 [| O | PF2 | 
| | | | | | | | | 1 | PFl | 


LUM) 


II.12 


Character Display Instructions: The first step in using the character 
map mode is to create a character set in memory (or the built-in OS 
character set at hex E000 may be used). The character set contains eight 
bytes of data for the graphics for each character. The meaning of the 
data depends on the mode. The character set can contain 64 or 128 characters, 
also depending on the mode. The MSB (Most Significant Byte) of the 
address of the character set is stored in CHBASE (or the OS Shadow CHBAS). 
Only the most significant six or seven bits of CHBAS are used (see CHBASE 
description in section III). The other one or two bits and the LSB of the 
address are assumed to be zero, so the character set must start at an 
acceptable page boundary. 


The next step is to set up the display list for the desired mode. 
Then the actual display is set up. This consists of a string of character 
mames or codes. Each name takes one byte. The last 6 or 7 bits of the 
name selects a character. For a 64 character set, the name would range 
from 0 through 63 (decimal). For a 128 character set, the range would be 
0 through 127 (decimal). The upper one or two bits of the name byte are 
used to specify the color or other special information, depending on the 
mode. 


Character names (codes) are fetched by the memory scan counter, and 
are placed in a shift register. On any given line of display the shift 
register rotates, changing only the name portion of the character address, 
as shown below. 


After a full line of character data has been displayed the line 
counter will increment. The next line again addresses all characters by 
name for that line nmumber. 


In 20 character per line modes the seven most significant bits of 
CHBASE are used. This requires that the character set to start upon a 512 
byte memory boundary. The set must contain 64 charcters, 8 bytes each, 
giving a total of 512 bytes for the set. 


The 40 character per line modes use the six most significant bits 
of CHBASE,forcing the character set to start on a 1K byte memory boundary. 
The set must have 128 characters of 8 bytes each. This gives a total of 
1024 bytes for the set. 


| Hex | Graphics | Chars. | Number | Bytes | Number | Bytes | 

| Code | Mode | Per | of | per | of Char. | in | 

| | Line Colors Char. in set Char Set 

| | | | | 

2 0 40 2 8 _128 1024 

| | bo | | | | 
3 - 40 2 8 128 1024 

| — | | | | | | 
4 - 40 4 8 128 1024 

| | | | | | | | 
5 - 40 4 8 128 1024 

| | | | | | | | 
6 1 20 5 8 64 512 

| | | | | | | 
7 2 20 5 8 64 512 


Character Display Internal 


codes for 
(20 Character per line mode example) characters 


in memory 


Codes (names) 
Stored in 
Shift Register 


Color Address portion of 
Register Character name 
Select 


CHBASE 


Ci tTiTiti 
Counter 


| AED E ETAT EARS ED ETRE 
eee eee eee 
a a SN APPS RSTO PN 


Character Data Address 


Character Set 
in Memory 


Addresses data in 
character set 


and displays on the 
TV 


TV 
Scan 
Lines 


Color assigned 
by color register 
selected 


NAOH WHF © 
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There are six charcter map modes, IR modes 2 through 7. Modes 2,6 
and 7 are supported by the OS and BASIC (GRAPHICS 0,1 and 2). 


In IR modes 6 and 7, the upper two bits of each character name select 
one of four playfield colors. For each data bit that contains a one, the 
selected playfield color is displayed. For each zero data bit, the 
background color is displayed. The four character colors plus the background 
color gives a total of five different colors. the mode 6 characters are 
eight lines high and the mode 7 characters are sixteen lines high (each 
data byte is displayed for two lines). 


In IR modes 4 and 5, each character is only four pixels wide instead 
of eight (as in the other modes). Two bits per pixel of data are used to 
select one of three playfield colors, or background. Seven name bits are 
used to select the character. If the most significant name bit is a zero 
then data of 10 (binary) selects PFl. If the name bit 7 is one, then data 
bits of 10 select PF2. This makes it possible to display two characters 
with different colors, using the same data but different name bytes. 


In IR modes 2 and 3, each pixel is half of a color clock in width. 
This makes it possible to have forty eight-pixel-wide characters in a 
standard width line. These modes are similar to memory mode F in that two 
luminances can be displayed, but only one color is available at a time. 
In IR mode 3, each character is 10 lines high. This makes it possible to 
define lower case characters with descenders- The last fourth of the 
character set (name bits 5 and 6 equal to one) is lowered. The hardware 
takes the first two data bytes and moves them to the bottom of the character, 
displaying two blank lines at the top of the character (see next page). 


In IR modes 2 and 3, bit 7 of the character name is used for inverse 
video or blanking. This is controlled by CHACTL (Character Control). If 
bit 2 of CHACTL is a one then all of the characters will be displayed 
upside down, regardless of mode. If CHACTL bit 1 is set, then each 
character which has bit 7 of its name set will be displayed in inverse 
video (the luminances will be reversed). If CHACTL bit 0 is set, then 
each character which has bit 7 set will be blanked (only background wil be 
displayed). Characters can be blinked on and off by setting name bit 7 to 
1 and toggling CHACTL bit 0. Inverse video and blank apply only to IR 
modes 2 and 3. If both inverse video and blank are set then the character 
will appear as an inverse video blank character (solid square). 


Hardware Collision Detection: 60 bits of collision register are 
provided to detect and store overlap (hits) between players, missiles and 
playfield. These collisions can be read by the microprocessor from 
addresses DOOO through DOOF. There are no bits for missile to missile 
collisions. 


16 bits for Missile to Playfield 

16 bits for Player to Playfield 

16 bits for Missile to Player 

12 bits for Player to Player (PO to PO always reads as zero, etc.) 


The 1/2 clock memory map mode (IR code 1111) and the 1/2 clock Character 
mode (IR codes 0011 and 0010) are both playfield type 2 collisions and will 
be stored in bit 2 of the playfield collision registers. 
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IR Mode 3-Upper and Lower Case 


Upper Case Lower Case 


Data 


Actual 
Display 
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Character Map Display Modes 


| os | | |Chars.|Scan |Color |Data {Color | Bit | | 
| and |Inst.]Colors | per |[Lines|Clocks|Bits |Select |Values|Color | 
|BASIC|Reg. | per | Std. | per | per | per [Bits In| in | Reg. | 
| Modes | HEX Mode Line |Char.|Pixel |Pixel] Name |Data |Select| 
| 

| o | 2 | 1% | 40 | 8 | &@ | 1 | = | O- | PF2 | 
| | | | | | | | | 1 | PFl | 
eRe CRaeeets, Apenerenes eeneotece amerece Deceeereren! Meneaceel UMeemnem.art Cem mermesen KC Ft), OS 
| | | | | | | | | | | 
| - | 3 { 1% | 40 | 10] % | 1 | = [| O | PF2 | 
| | | | | | | | 1 | PFL | 
[Eemnan Coeteneet LMRMOE eR a Maeeeenet| Ne entene (omnerireme /eeeactnenl OMmaennare ereneterte (00). 0m, 
| | | | | | | | | 0O | BAK | 
J} - | 4 | 5 {| 40 | 8 {| 1 | 2 {Bit 7 | 01 | PFO | 
| | | | | | | |=0O |10 | PFI | 
| | | | | | | | | 11 | PF2 | 
| | | | | | | | | | | 
| | | | | | | |Bit 7 | 11 | PF3 ! 

= ] 

| | | | | | | | | 00 | BAK | 
; =- | 5 | 5 ; 40 | 16] 1 | 2 |Bit 7 | Ol | PFO | 
| | | | | | | }=0O |10 | PFI | 
| | | | | | | [| 11 | PF2 | 
| | | | | | | | | | | 
| | | | | | | [Bit 7 | 11 | PF3 | 
| = 1 | 
| | | | | | | | - | oO | BAK | 
f 1 | 6 | 5 ; 20 | 8 {| 1 |} 1 | 00 ak | PFO | 
| | | | | | | (f iOk ij Ue “PE 4 
| | | | | | PotG: f° ap REZ <°] 
l l l | l | | | 11 | 1 | PF3 | 
a ee | ee eo eae 
} 2 | 7 | 5 | 20 | 16 | 1 / 1 | OO } 1 | PFO | 
| | | | | | Ol | 1 | PFI | 
| | | | | | | | 10 | 1 | PF2 | 
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Vertical and Horizontal Fine Scrolling: Playfield objects are difficult 
to move smoothly. Memory map playfield can be moved by rewriting sections 


of memory. However, this is extremely time-consuming if large sections 
of the screen must be moved smoothly. Character playfield objects can be 
moved easily in a jerky fashion by changing the memory scan counter. 
However, this results in a large position jump from one character position 
to another, not a smooth motion. For this reason hardware registers 
(VSCROL and HSCROL) and counters are provided to allow smooth horizontal 
or vertical motion, up to one character width horizontally and up to one 
character height vertically. After this mich smooth motion has been 
done by increasing the value in these registers, memory is rewritten or 
the memory scan counter is modified and smooth motion is resumed for 
another character distance. 


Vertical Scrolling: A zone of playfield on the screen can be scrolled 
upward by using VSCROL and bit 5 of the display list instruction. The 
display blocks at the upper and lower boundaries of the zone must have a 
variable vertical size. In particular, the first display block within that 
zone must be shortened from the top, and the last display block must be 
shortened from the bottom (i.e. not all of the top and bottom blocks will 
be displayed). 


The vertical dimension of each display block is controlled by a 4 bit 
counter within the ANTIC, called the “Delta Counter’ (DCTR). Without 
vertical scrolling, it starts at 0 on the first line, and counts up to a 
Standard value, determined by the current display instruction. (Ex: 
for upper and lower case text display, the end value is 9. For 5 color 
character displays, it is 7 or 15.) 


If bit 5 of the instruction remains unchanged between consecutive 
display blocks, then the second block is displayed in the normal fashion. 
If bit 5 of the instruction goes from 1 to 0 between two consecutive 
display blocks, the second block will start with Delta = 0, as usual, but 
will count up until delta=VSCROL, instead of the standard value. This 
shortens that display block from the bottom. 


To define a vertically scrolled zone, the most direct method is to 
set bit 5 to 1 in the first display instruction for that zone, and in all 
consecutive blocks but the last one. If the VSCROL register is not 
rewrittren on the fly, this results in a total scrolled zone that has a 
constant number of lines (provided that the VSCROL value does not exceed 
the standard individual block size). If N is the standard block size, the 
top block will be N-VSCROL lines (N > VSCROL ), and the last block will be 
VSCROL + 1 lines: (N-VSCROL) + (VSCROL + 1) = N+ 1- Shown on the 
following page is an example of a scrolled zone, top block, for 8 VSCROL 
values for N = 8. 


Horizontal scrolling is described under HSCROL in section III. 
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Simple Display List Example: BASIC starts out in OS graphics mode 0 
which displays 40 characters across by 24 rows. This is IR mode 2 with a 
standard screen width. The OS sets up the display list near the top of 
RAM with room for the character names at the top of RAM. On a 32 K-byte 
machine, the display list would start at hex 7C20. The next three bytes 
are hex 70’s to create 24 blank lines. The next byte is a hex 42. The 
4 tells the hardware to reload the memory scan counter with the following 
address (7C40). This is the address of the data to be displayed. The 2 
tells the hardware to display one line of IR mode 2 characters. The 
next 23 bytes specify 23 more lines of mode 2 characters. Hex 41 is the 
code for jumping and waiting until the end of the next vertical blank. 
The address to jump to is 7C20, the start of the display list. The next 
960 bytes are the list of characters to be displayed, 40 bytes per line. 
The OS mst set up the display list pointer (DLISTH and DLISTL) to the 
starting address of the display list (7C20). It also sets CHBASE to the 
MSB of the address of the character set (E0). 


This is a simple example because only one mode is used and the memory 
scan counter is only loaded at one point. It is possible to have different 
modes on different lines, change character sets and colors, etce, as shown 
in the example in Section IV. 
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OS Mode 0 Display List (40 chars x 24 lines) 


Address (hex) Data (hex) 
7C20 70 
70 24 blank lines 
70 
42 reload memory scan counter with 7C4C 
40 IR mode 2 


Jump back to 7C20 and 
wait for end of vertical blank. 


7C40 
960 bytes of display data 
(character names) 


Z 

2 

2 

‘ 23 more IR mode 2 instructions 
Z 

9 

2 

1 

; 

C 


Cycle Counting: As explained previously, the ATARI 800 6502 micropro- 
cessor runs at a rate of 114 machine cycles per TV line (1.79 MHZ). There 
are 262 lines per TV frame and 60 frames per second on the NTSC (US) system. 
(The PAL (Europeon) system is different. See the section on NTSC vs. PAL.) 


Each machine cycle is equivalent in length to 2 color clocks. There 
are 228 color clocks on a TV line. The highest resolution graphics modes 
have a pixel size of 1/2 color clock by 1 TV line. Horizontal blank takes 
40 machine cycles. This is when the beam returns to the left edge of the 
screen in preparation for displaying the next TV line. A wait for Sync 
(WSYNC) instruction stops the 6502. The processor is restarted exactly 7 
machine cycles before the beginning of the next TV line. The program can 
thus change graphics or colors during horizontal blank in preparation for 
the next line. 


The ANTIC chip steals cycles from the 6502 in order to do memory 
refresh and fetch graphics data when needed. The general rule to remember 
is that each byte fetched from memory requires one machine cycle. If a 
display list memory map instruction extends over several lines then the data 
is only fetched on the first line. Memory refresh takes 9 cycles out of 
every line, unless pre-empted by a high-resolution graphics mode. Memory 
refresh continues during vertical blank. 


Missile DMA takes one cycle per line in the one-line resolution mode 
and one cycle every other line in the two line resolution mode. Missile 
DMA can be enabled without doing player DMA. However, if player DMA is 
enabled then missile DMA will also be done (see DMACTL, GRACTL bits). 
Player DMA requires 4 cycles every one or two lines, depending on the 
resolution used. 
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Each fetch of a display list byte takes one cycle, so three cycle: 
are required for a three byte instruction. 


Player/missile and display list instruction fetch DMA take place 
during horizontal blank, if they are required for the next line. 


In memory map modes, the graphics data is fetched as needed throughout 
the first line of the display list instruction, then saved by ANTIC for 
use in succeeding lines. In character modes, the character codes are 
fetched during the first line of each row of characters, along with the 
graphics data needed for that line. On the next lines, only the graphics 
data is fetched, since ANTIC remembers the character codes. 


In the 40 x 24 character mode, with a standard screen width, most of 
the cycles during the top line of each row of characters are requried to 
fetch the character codes and data, so there is only time for one memory 
refresh cycle instead of the usual nine. Less DMA is required with a narrow 
screen width so two memory refresh cycles would occur in this case. 


The memory refresh is done fast enough to make up for the lost cycles 
in the high resolution modes. Once memory refresh starts on a line, it 
occurs every four cycles unless pre-empted by DMA. 


All interrupts reach the 6502 near the end of horizontal blank. 
With standard or narrow screen widths, refresh DMA starts after the end of 
horizontal blank. 


The time at which ANTIC does cycle stealing is deterministic, but 
depends on the graphics mode, screen width and whether or not horizontal 
scrolling is enabled. Horizontal scrolling requires extra graphics data: 
see HSCROL. 


ANTIC does horizontal scrolling of an even mumber of color clocks by 
delaying the time at which it DMA’s the data. To do an odd number of color 
clocks (which involves half of a machine cycle), ANTIC has a one color clock 
internal delay. 


Theoretically, it is possible to write a program which changes graphics 
or colors “on the fly", iee. during the middle of a TV line. However, 
with all the DMA going on, the cycle counting gets to be quite complicated, 
and is beyond the scope of this manual. 


There are a mumber of delays associated with the display of graphics. 
These occur in the ANTIC and the CTIA. The ANTIC sends data to the CITA 
which adds in the color information. Thus the timing for changing colors on 
the fly is different from that for changing graphics on the fly. 
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Horizontal Blank DMA Timing 


When DMA is enabled, cycles are stolen at the times shown below. 


End of 
ieee , Horizontal Blank 
ne 


20 machine cycles (40 color clocks) 


1-9 refresh cycles. 

chare and graphics 
WSYNC data DMA (depends on 

graphic mode) 


Interrupt 

Address DMA (3=-byte display list 
instruction) 

Player 

Display list instruction fetch DMA 

Missile DMA 


Cycle Counting Example: This example uses the 40 character by 24 line 
display list given on page II.24. This display list is 32 bytes long so 
display list DMA takes 32 machine cycles. It takes 960 cycles to DMA the 
characters and 8*960 to DMA the character data. The refresh DMA takes 9 
cycles for each of 262 lines, except for the 24 lines where the characters 
are read, where only 1 refresh cycle occurs. 


DMA description Machine cycles 
display list 32 
characters 40x24 = 960 
character data 960x8 =7680 
refresh 262x9-24x8 =2166 
total 10838 


Thus the total DMA per frame is 10838 machine cycles. One frame 
is 262 lines with 114 machine cycles per line for a total of 29868 machine 
cycles per frame. Thus 36% of each frame is required for DMA in OS graphics 
mode 0. 


NTSC vs. PAL Systems: There are two versions of the ATARI 800: the NTSC 
(United States T.V. standard) and PAL (one of the European T.V. standards). 
The PAL system has been designed so that most programs will run without 
being modified. However, some differences may be noticeable. There is a 


hardware register (PAL) which a program can read to determine which type of 
System it is running on and adjust accordingly. 
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The PAL T.V. has a slower frame rate (50 Hz. instead of 60 Hz.) so 
games will be slower unless an adjustment is made. PAL has more T.V. 
lines per frame (312 instead of 262). The Atari 800 hardware compensates 
for this by adding extra lines at the beginning of vertical blank. Display 
lists do not have to be altered. However, their actual vertical height will 
be shortere PAL ATARI 800 colors are similar to NISC because of a hardware 
modification. 


Be POKEY 


Audio: There are 4 semi-independent audio channels, each with its own 
frequency, noise, and volume control. Each has an 8 bit "divide by N" 
frequency divider, controlled by an 8 bit register (AUDFX). (See audio-serial 
port block diagram.) Each channel also has an 8 bit control register (AUDCX) 
which selects the noise (poly counter) content, and the volume. 


Frequency Dividers: All 4 frequency dividers can be clocked simultane- 
ously from 64 KHZ or 15 KHZ. (AUDCTL bit 0)- Frequency dividers 1 and 3 
can alternately be clocked from 1.79 MHZ (AUDCTL bits 6 and 5). Dividers 2 
and 4 can alternately be clocked with the output of dividers 1 and 3 (AUDCTL 
bits 4 and 3). This allows the following options: 4 channels of 8 bits 
resolution, 2 channels of 16 bit resolution, or 1 channel of 16 bit and 2 
channels of 8 bit. 


Poly Noise Counters: There are 3 polynomial counters (17 bit, 5 bit 
and 4 bit) used to generate random noise. The 17 bit poly counter can be 
reduced to 9 bits (AUDCTL bit 7). These counters are all clocked by 1.79 
MHZ. Their outputs, however, can be sampled independently by the four 
audio channels at a rate determined by each channel’s frequency divider. 
Thus each channel appears to contain separate poly counters (3 types) 
clocked at its own frequency. This poly counter noise sampling is controlled 
by bits 5,6 and 7 of each AUDCX register. Because the poly counters are 
sampled by the "divide by N" frequency divider, the output obviously cannot 
change faster than the sampling rate. In these modes (poly noise outputted) 
the dividers are therefore acting as "low pass" filter clocks, allowing only 
the low frequency noise to pass. 


The output of the noise control circuit described above consists of 
pure tones (square wave type), or polynomial counter noise at a maximum 
frequency set by the "divide by N" counter (low pass clock). This output 
can be routed through a high pass filter if desired (AUDCTL bits 1 and 
2). 
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Audio Noise Filters: 


VOL 
Low pass noise cut off set 
by Divide by N counter. 


Low Frequency 
Noise 


Frequency 
Any channel noise output (without high pass filter) 
VOL 
Channel 3 Channel 1 
- by N - by N 
Frequency 
Channel 1 output (with high pass filter) 
VOL 
Channel 4 Channel 2 
(or 3 & 4) (or 1 & 2) 
- by N - by N 
Frequency 


Channel 2 output (with high pass filter) 


Clock 


LDR 
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High Pass Filters: The high pass filter consists of a "D" flip flop 
and an exclusive-OR Gate. The noise control circuit output is sampled by 
this flip flop at a rate set by the "High Pass" clock. The input and output 
of the Flip Flop pass through the exclusive-OR Gate. If the flip flop input 
is changing mch faster than the clock rate, the signal will pass easily 
through the exclusive-OR Gate. However, if it is lower than the clock rate, 
the flip flop output will tend to follow the input and the two exclusive-OR 
Gate inputs will mostly be identical (11 or 00) giving very little output. 
This gives the effect of a crude high pass filter, passing noise whose 
minimum frequency is set by the high pass clock rate. Only channels 
1 and 2 have such a high pass filter. The high pass clock for channel l 
comes from the channel 3 divider. The high pass clock for channel 2 comes 
from the channel 4 divider. This filter is included only if bit 1 or 2 of 
AUDCTL is true. 


Volume Control: A volume control circuit is placed at the output of 
each channel. This is a crude 4 bit digital to analog converter that 
allows selection of one of 16 possible output current levels for a logic 
true audio input. A logic zero audio input to this volume circuit always 
gives an open circuit (zero current) output. The volume selection is 
controlled by bits 0 thru 3 of AUDCX. "Volume Control only" mode can be 
invoked by forcing this circuit’s audio input true with bit 4 of AUDCX. In 
this mode the dividers, noise counters, and filter circuits are all discon- 
nected from the channel output. Only the volume control bits (0 to 8 of 
AUDCX) determine the channel output current. 


The audio output of any channel can be completely turned off by writing 
zero to the volume control bits of AUDCX. All ones gives maximum volume. 


C. SERIAL PORT 


The serial port consists of a serial data output (transmission) 
line, a serial data input (receiver) line, a serial output clock line, a 
bi-directional serial data clock line, and other miscellaneous control lines 
described in the Operating System Manual. Data is transmitted and received 
as 8 bits of serial data preceded by a logic zero start bit, and succeeded 
by a logic true stop bit. Input and output clocks are equal to the baud 
(bit) rate, not 16 times baud rate. Transmitted data changes when the 
output clock goes true. Received data is sampled when the input clock goes 
to zero. 


Serial Output: The transmission sequence begins when the processor 
writes 8 bits of parallel data into the serial output register (SEROUT) (see 
audio and serial port block diagram). When any previous data byte trans- 
mission is finished the hardware will automatically transfer new data from 
(SEROUT) to the output shift register, interrupt the processor to indicate 
an empty (SEROUT) register (ready to be reloaded with the next byte of 
data), and automatically serially transmit the shift register contents with 
start-stop bits attached. If the processor responds to the interrupt, and 
reloads SEROUT before the shift register is completely transmitted, the 
serial transmission will be smooth and continuous. 
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Output data is normally transmitted as logic levels (+4V=true OV=False). 
Data can also be transmitted as two tone information. This mode is selected 
by bit 3 of SKCTL. In this mode audio channel 1 is transmitted in place of 
logic true, and audio channel 2 in place of logic zero. Channel 2 mst be 
the lower tone of the tone pair. 


The processor can force the data output line to zero (or to audio 
channel 2, if in two tone mode) by setting bit 7 of SKCTL. This is required 
to force a break (10 zeros) code transmission. 


Serial Output Clock: The serial output data always changes when the 
serial output clock goes true. The clock then returns to zero in the center 
of the output data bit time. 


The baud (bit) rate of the data and clock is determined by audio 
channel 4 audio channel 2, or by the input clock, depending on the serial 
mode selected by bits 4, 5, and 6 of SKCTL. (See chart at end of this 
section.) 


Serial Input: The receiving sequence begins when the hardware has 
received a complete 8 bit serial data word plus start and stop bits. This 
data is automatically transferred to the 8 bit parallel input register 
(SERIN), and the processor is interrupted to indicate an input data byte 
ready to read in SERIN. The processor must respond to this interrupt, and 
read SERIN, before the next input data word reception is complete, otherwise 
an input data "over-run" will occur. This over-run will be indicated by bit 
5 of SKSTAT (if bit 5 of IRQST is not RESET (true) before next input complete), 
and means input data has been lost. This bit should be tested whenever 
SERIN is read. Bit 7 of SKSTAT should also be tested to detect frame errors 
caused by extra (or missing) data bits. 


Direct Serial Input: The serial data input line can be read directly 
by the microprocessor if desired, ignoring the shift register, by reading 
bit 4 of SKSTAT. 


Bi-Directional Clock: This clock line is used to either receive a 
clock from an external clock source for clocking transmitted or received 
data, or is used to supply a clock to external devices indicating the 
transmit or reception rate. This clock line direction is determined 
by the serial mode selected by bits 4, 5, and 6 of SKCTL. (See mode chart 
at the end of this section.) Transmitted data changes on the rising edge of 
this clock. Received data is sampled on the trailing edge of this clock. 


Asynchronous Serial Input: Unclocked serial data (at an approximately 
known (+5%) rate) can be received in the asynchronous modes. The receive 
(input) shift register is clocked by audio channel 4. Channels 3 and 
4 should be used together (AUDCTL bit 3 = 1) for increased resolution. 

In asynchronous modes, channels 3 and 4 are reset by each start bit at the 
beginning of each serial data byte. This allows the serial data rate to be 
slightly different from the rate set by channels 3 and 4. 
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Serial Mode Control: There are 6 useful modes (of the possible 8) 
controlled by bits 4, 5, and 6 of SKCTL. These are described on the next 
page. 

Note that two tone output (bit 3 of SKCTL) may be used in any of these 
modes except for the bottom pair. This is because channel 2 is used to set 


the output transmit rate and is therefore not available for one of the two 
tones. 


Note that the output clock rate is identical to the output data rate. 


Serial Mode Control (see also register description SKCTL): 


Force Break 


‘[p7 (D6 [D5 [D4 [D3 [D2 {D1 |DO| SKCTL REGISTER 
| | | | 
| | | | Pot scan and keyboard CTRL 
| | Tod 
} | 7d Two Tone Control 
| | t | 
f | | | 
| | [| | 
| | | 


Mode Control Bits A=asynchronous 
Out | Out | In | Bi-Dir | 
D6/D5|D4|Rate Clock| Rate Clock Comments 
Poa ak | | | ext |Trans. & Receive rates set by | 
10 |O |O Jext | ext | ext | input Jexternal clock. Also internal | 


| | | | | | | [clock phase reset to zero. | 


ieee ent jee | chan | ext |Trans. rate set by external | 

10 J]O [1 Jext | ext | 4 | input |clock. Receive asynch. (ch. 4) | 

| | {| | | | A | | (CH3 and CH4) | 

Paes eee [ieeateaee wy [Dap ie en (eee an ee he ae ain et re Me ere ae | 

; [| - of | | | chan |Trans. & Receive rates set by | 

10 |1 JO |chan| chan | chan | 4 |Chan. 4. Chan. 4 output on Bi-| 
4 4 4 output Directional clock line. 

JO {1 [1 |cH4 | cH4 | CH4 | |Not Useful | 
A A A input 

| | | |ehan] chan | ext | ext |Trans.- Rate Set by Chan. 4 | 

11 Jo {jo | 4 | 4 | | input |Receive Rate set by External | 

| | | | | | | [Clock. | 

{1 |O {1 |cH4 | CH4 | CH4 | |Not Useful | 
A A A input 

| | | |{Chan] Chan | Chan | Chan |frans.e rate set by chan. 2 | 

f1 11 JO | 2 | 2 | 2 | 4 |Recieve rate set by chan. 4 Chan.| 

Output 4 out on Bi-Direct. Clock line. 

1 | | 4d | | | Input |Trans. Rate set by Chan. 2. Re-| 

J}1 J]1 [1 [Chan] Chan | Chan | not |ceive async. (chan 3&4) Bi-Dir.| 

tf | | 


} 2 | 2 | 4 | used |Clock not used (Tri-state condi- | 


ee fils | | A | | tion) | 


Two tone (bit3) not useable in these modes 
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D. INTERRUPT SYSTEM 


There are two basic types of interrupts defined on the microprocessor: 
NMI (non maskable interrupt) and IRQ (interrupt request). It is recommended 
that a thorough understanding of these interrupt types be acquired by 
reading all chapters concerning interrupts in the 6502 microprocessor 
programming and hardware manuals. 


In this system NMI interrupts are used for video display and reset. 
IRQ interrupts are used for serial port communication, peripheral devices, 
timers, and keyboard inputs. 


NMI Interrupts: Even though NMI interrupts are "unmaskable" on 
the micrprocessor, this system has interrupt enable (mask) bits for NMI 
function. (Bits 6 and 7 of NMIEN) When these bits are zero NMI interrupts 
are disabled (masked) and prevented from causing a microprocessor NMI 


interrupt. (see NMIEN register description) The 3 types of NMI interrupts 
are: 


l. D7 = Instruction Interrupt (during display time any display 
instruction with bit 7=l will cause this interrupt to occur 
(if enabled) at the start of the last video line displayed by 
that instruction.) 


2. D6 = Vertical Blank Interrupt (interrupt occurs (if enabled) at 
the beginning of the vertical blank time interval.) 


36 D5 = Reset Button Interrupt (pushing the SYSTEM RESET button will 
cause this interrupt to occur.) 


Since any of these interrupts will cause the processor to jump to the 
same NMI address, the system also has NMI status bits which may be examined 
by the processor to determine which source caused the NMI interrupt. Bits 
5, 6, and 7 of NMIST serve this function (see NMIST register description). 
These status bits are set by the corresponding interrupt function (even if 
the interrupt is masked from the processor by NMIEN). The status bits may 
be reset together by writing to the address NMIRES. 


Two of the interrupt enable bits (bits 6 and 7 of NMIEN) are cleared 
automatically during system power turn on and therefore these NMI interrupts 
are initially disabled (masked), preventing any power turn on service routine 
from being interrupted before proper initialization of registers and pointers.* 
They can then be enabled by the processor whenever desired, by writing into 
bits 6 and 7 of NMIEN. Except for the reset button interrupt, they can also 
be disabled by the processor by writing a zero into bits 6 or 7 or NMIEN. 

The reset button cannot be disabled, allowing an unstoppable escape from any 
possible "hangup" condition. 


These NMI interrupt functions are each separated in time (to prevent 


overlaps) and converted to pulses by the system hardware, in order to supply 
NMI transitions required by the microprocessor logic. 


* - NOTE: Bit 5 is never disabled and therefore the Reset Button 
should not be pressed during. power turn on. 
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IRQ Interrupts: IRQ interrupts are all "maskable" together by one bit 
of the status register on the microprocessor. This bit is set to the 
disable condition automatically by power turn on to prevent interrupt of 
power turn on service routines.** In addition to this processor IRQ mask 
bit, there are separate system IRQ interrupt enable bits for each IRQ 
interrupt function (bits 0 thru 7 of IRQEN). These bits are not initialized 
by power turn on, and must be initialized by the program before enabling the 
processor IRQ. The 8 types of IRQ interrupts are: 


D7 = BREAK KEY (depression of the break key) 

D6 = OTHER KEY (depression of any other key) 

D5 = SERIAL INPUT READY (Byte of serial data has been received and is 
ready to be read by the processor in SERIN register). 

D4 = SERIAL OUTPUT NEEDED (Byte of serial data is being transmitted and 
SEROUT is ready to be written to again by the processor). 

D3 = TRANSMISSION FINISHED (serial data transmission is finished. 
Output shift register is empty). 

D2 = TIMER #4 (audio divider #4 has counted down to zero) 

Dl = TIMER #2 (audio divider #2 has counted down to zero) 

DO = TIMER #1 (audio divider #1 has counted down to zero) 


In addition to the above IRQ interrupts (enabled by bits 0 through 7 of 
IRQEN and identified by status bits 0 thru 7 of IRQST) there are two more 
system IRQ interrupts which are generated over the serial bus Proceed and 
Interrupt lines. 


D7 of PACTL = peripheral "A" interrupt status bit 
DO of PACTL = peripheral "A" interrupt enable bit 
D7 of PBCTL = peripheral "B" interrupt status bit 
DO of PBCTL = peripheral "B" interrupt enable bit 


These last two interrupts are automatically disabled by power turn on, 
and their status bits are reset by reading from port A register and port B 
register. (See PORTA, PACTL, PORTB, and PBCTL Register descriptions.) 


The IRQEN register, like the NMIEN register, enables interrupts 
when its bits are 1 (logic true). The IRQST however (unlike the NMIST) has 
interrupt status bits that are normally logic true, and go to zero to 
indicate an interrupt request. The IRQST status bits are returned to logic 
true only by writing a zero into the corresponding IRQEN bit. This will 
disable the interrrupt and simultaneously set the interrupt status bit to 
onee Bit 3 of IRQST is not a latch and does not get reset by interrupt 
disable. It is zero when the serial out is empty (out finished) and true 
when it is not. 


*k ~ NOTE: An NMI also disables the I bit. 
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INTERRUPT SUMMARY 


| | | | | STATUS | 
NAME FUNCTIONS ENABLE STATUS RESET | 

| | | | | | 
| | Display | NMIEN | NMIST | Address | 
| NMI JInstruction |(Bits 6 thru 7)|(Bits 5 thru 7) | NMIRES | 
|INTERRUPTS|Vert. Blank | Normally Zero | Normally Zero |(Resets all NMI | 
Reset Button Disabled) no interrupt) |status together) | 

| | | | | | 
| | KEYS | IRQEN | IRQST | Reset (to true) | 
| Serial |(Bits 0 thru 7)|(Bits 0 thru 7)| By Zero in | 
| | ports | zero is | Normally True | Corresponding | 
| | Timers | (Disabled) * |(no interrupt) | Bit of IRQEN | 
| | | | (except Bit 3)*| 
| IRQ | | | | | 
|INTERRUPTS| Peripheral | DO of PACTL | D7 of PACTL | Reset by | 
| | A [Normally Zero |Normally Zero | Reading PORT A | 
| | Disabled) no interrupt) Register | 
| | | | | | 
| | Peripheral | DO of PBCTL | D7 of PBCTL | Reset by | 
| | B [Normally Zero |Normally Zero | Reading PORT B | 
Disabled) no interrupt) Register | 


E. CONTROLLERS 


A variety of controllers can be plugged into the four jacks on the 
front of the console. This includes joysticks, paddle (pot), twelve-key 
keyboard, and light pen (when available). 


The controller ports are read through the PORTA and PORTB regisers 
and the POT and TRIG registers. The OS reads these registers during 
vertical blank and stores into its own RAM locations. These are STICK, 
PADDLO through PADDL7, PTRIG’S and STRIG’S. The OS sets up PORTA AND 
PORTB for input. This is done by setting PACTL or PORTB (Port Control) 
bit 2 to a O (to select the direction control register), then writing all 
0’s to the desired port. PACTL (PBCTL) bit 2 is then changed back to 
al, allowing the program to read from the port. The ports can also be 
set up for output by writing 1’s instead of 0’s while the direction control 
mode is selected. 


Joysticks: The joysticks have four switches, one each for right (R), 
left (L), back (B) and forward (F). 


These switches are read through PORTA and PORTB. A fifth switch is 
activated by pressing the red trigger button. The trigger buttons are 
read from TRIGO through TRIG3. A value of 0 indicates that a button has 
been pressed and a 1 indicates that it has not been pressed. 
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The TRIG registers are normally read directly, but they can be used 
in a latched mode. Writing a zero to bit 2 of GRACTL disables the latches 
and sets them to l. Writing a 1 to bit 2 enables the latches. If a joy- 
stick trigger button is pushed at any time while bit 2 of GRACTL is l 
the latch value will change to zero and stay that way. A program can 
use this to determine whether the joystick trigger buttons have ever been 
pressed during a certain period of time. 


Paddles: The paddles come in pairs, so eight paddles can be connected 
to the four jacks. The paddles are read by storing into POTGO, then 
reading the POT registers at least 228 lines later. The values range from 0 
(with the paddle turned to the right) to 228 (paddle turned counter-clockwise). 
The value indicates how many TV lines it takes to charge up the capacitor 
which is the series with the potentiometer. Turning the knob to the right 
lowers the resistance, so the capacitor charges up quickly. Turning the 
knob to the left increases the resistance and the charging time. The 
capacitor dump transistors are used to discharge the capacitors so that a 
new reading can be mode. The POTGO command clears the counters and turns 
off the dump transistors to allow the capacitors to charge upe The ALLPOT 
register contains one bit for each paddle. When the capacitor has charged 
up to the threshold value the ALLPOT bit changes fron one to zero and the 
POT register contains the correct readings. Bit 2 of SKCTL (Serial Port 
Control) enables fast pot scan. In this mode, It takes only two scan lines 
to charge up the capacitors to the maximum level instead of 228 lines. Bit 
2 is first set to 0 to dump the capacitors. Then Bit 2 is set to 1 to start 
the pot scan. The fast pot scan is not as accurate as the normal scan mode. 
Bit 2 of SKCTL must be set to 0 to use normal scan mode. Otherwise, the 
capacitors will never dump. Note that some paddles have a range smaller 
than 0 to 228 due to differences in the pots. The left and right paddle 
triggers for each paddle pair are read from the left and right bits for the 
corresponding joystick (PORTA or PORTB). 


Keyboard Controllers: Each keyboard controller has a twelve-key pad 
and plugs into a joystick controller port. The first step in using the 
keyboard is to select a row by setting the port direction to output and 
writing a 0 to the bit in the PORTA or PORTB register which selects the 
desired row (see PORTA, SECTION III). The other rows should have l’s 
written to them. Columns are read through the POT and TRIG registers (see 
controller PORT PINOUT chart in section III). Appendix H of the BASIC 
Reference Manual contains a Basic program which reads the controllers. The 
first and second columns of the keyboard use the same pins as the pots for 
the paddle controllers, so they are read by reading the POT (or PADDL) 
registers. When a button is pushed, the pot line is grounded, so the pot 
capacitors never charge up to the threshold level and the reading is 228 
(the maximum). When the button in the selected row and column is not pushed 
the capacitor is connected to +5V through a relatively small resistor, 
giving a POT value of about 2 (this may vary). Since the reading is not 
critical, the fast pot scan mode can be used, so that only a 2 line wait is 
required between selecting the row and reading the POT register. The 
convention has been adopted of comparing the POT reading with 10 (decimal). 
If is it greater than 10 then the button has been pressed. The third 
column is read through the joystick trigger line, so it works just like a 
joystick trigger (O0=button is pressed, l=not pressed). 
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Light Pen: A light pen is a device that can detect the electron beam 
as it sweeps across the TV screen.e It is used to point directly at an image 
on the TV display- Applications include selecting menu items and drawing 
lines. The ATARI 400/800 hardware was designed so that a light pen can be 
plugged into any of the joystick controller ports (see end of section 
III). 


When any one of the joystick trigger lines (pin 6) is pulled low, the 
ANTIC chip takes the current VCOUNT value and stores it in PENV. The 
horizontal color clock value (0-227 decimal) is stored in PENH. The least 
significant bit is inaccurate and should be ignored. Since there are a 
number of delays involved in displaying the data and changing the light 
pen register, each system mst be cal brated. Software which uses the 
light pen should contain a user-interactive calibration routine. For 
example, the user could point the light pen at a crosshair in the center 
of the screen and the program could compute the required horizontal offset. 
PENH will wrap around from 227 to O near the right hand edge of a standard 
width display because of the delay. The pen will not work if it is pointed 
at a black area of the screen, since the electron beam is turned off. It is 
a good idea to read two (or more) values and average them, since the user 
will probably not hold the pen perfectly steady. 
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III. HARDWARE REGISTERS 


This section lists the hardware registers and Operating System (0S) 
shadow registers. 


In the following descriptions, true always refers to a bit whose value 
is l. 


Ae PAL (D014) 


Not | D3 | D2 | D1 {Not 
Used Used 


1 1 1 NTSC (US TV) 
0 0 0 PAL (European TV) 
This byte can be read by a program to determine which type of system 
the program is running on. 


Be INTERRUPT CONTROL 


NMIEN (Non Maskable Interrupt Enable) (D40E): This address writes data 
to the NMI interrupt enable bits. 


0 = disabled (masked) 
1 = enabled 
| | Not 
D7 D6 Used 


D7 Display List Instruction Interrupt Enable. This bit is 
cleared by Power Reset, and may be set or cleared by the 
processor. 


D6 Vertical Blank Interrupt Enable. This bit is cleared by Power 
Reset, and may be set or cleared by the processor. 


SYSTEM RESET Button Interrupt 


This interrupt is always enabled. The SYSTEM RESET button should 
not be pressed during power turn on. 


(Set to hex 40 by OS IRQ code.) 


IIfI.l 


NMIST (Non Maskable Interrupt Status) (D40F): This address read the NMI 
Status Register (Read by OS NMI code). 


jon) 
I 


= no interrupt 
interrupt 


— 
i] 


| | | Not 
D7 D6 D5 Used 


D7 This bit identifies an NMI interrupt caused by bit 7 of a 
Display List Instruction. 


D6 This bit identifies an NMI interrupt caused by the beginning 
of vertical blank. 


D5 This bit identifies an NMI interrupt caused by the SYSTEM 
RESET button. 


NMIRES (NMI Status Register Reset) (D40F): This write address resets 


the Non Maskable Interrupt Status Register (NMIST). 


Used 
( Written by OS NMI code.) 


IRQST (IRQ Interrupt Status) (D20E): This address reads the data from 


the IRQ Interrupt Status Register. 


jo) 
i 


= Interrupt 
= No Interrupt 


— 
| 


Break Key Interrupt 

Other Key Interrupt 

Serial Input Data Ready Interrupt 

Serial Output Data Needed Interrupt 

Serial Output (Byte) Transmission Finished Interrupt * 
Timer 4 Interrupt 

Timer 2 Interrupt 

Timer 1 Interrupt 


oO 

> 

it 
ooooo°o°o 0 


* - NOTE: Used for generation of 2 stop bits. See IRQ description 
in section II (no direct reset on bit 3). 
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IRQEN (IRQ Interrupt Enable) (D20E): This address writes data to the IRQ 


Interrupt Enable bits. 


0 = disable, corresponding IRQST bit is set to l 
1 = enable 


D7 #£Break Key Interrupt Enable 

D6 Other Key Interrupt Enable 

D5 Serial Input Data Ready Interrupt Enable 

D4 Serial Output Data Needed Interrupt Enable 

D3 Serial Out Transmission Finished Interrupt Enable 
D2 Timer 4 Interrupt Enable 

Dl Timer 2 Interrupt Enable 

DO Timer 1 Interrupt Enable 


OS SHADOW: POKMSK (hex 10) 


Use AND’s and OR’s to change one bit in POKMSK without affecting 
the others. Store the desired value in both IRQEN and POKMSK. 


C. TV LINE CONTROL 


VCOUNT (Vertical Counter) (D40B): This address reads the Vertical TV 


Line Counter (8 most significant bits). 


VO not read. 
v8 V7 V6 V5 V4 V3 V2 Vl VO Two line 

resolution 

supplied. 


WSYNC (Wait for Horizontal Blank Synchronism - i.e. wait until start of 
next TV line.) (D40A): 


This address sets a latch that pulls down on the RDY line to the 
microprocessor, causing it to wait until this latch is automatically reset 
by the beginning of horizontal blank. Display list interrupts may be 
delayed by 1 line if WSYNC is used. (Used by OS keyboard click routine.) 
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D. GRAPHICS CONTROL 


DMACTL (Direct Memory Access Control) (D400): This address writes data 


into the DMA Control Register. 


D1,D0 


See GRACTL. 


1 


1 


1 


1 


Enable instruction fetch DMA 
1 Line P/M resolution 

2 line P/M resolution 

Enable Player DMA — 

Enable Missile DMA 

0 No Playfield DMA 


1 Narrow Playfield DMA 
(128 Color Clocks) 


0 Standard Playfield DMA 
(160 Color Clocks) 


1 Wide Playfield DMA 
(192 Color Clocks) 


OS Shadow: SDMCTL (22F) default value hex 22 


GRACTL (Graphics Control)(DOID): This address writes data to the 


Graphic Control Register. 


Not 
Used 


D2 


D1 


DO 


1 


1 


Enable latches on TRIGO - TRIG3 inputs (latches are 
cleared and TRIGO - TRIG3 act as normal inputs when this 
control bit is zero). 


Enable Player DMA to Player Graphics Registers. 


Enable Missile DMA to Missile Graphics Registers. 


DMA is enabled by setting bits in both DMACTL and GRACTL. Setting 
DMACTL only will result in cycles being stolen but no display will be 


generated. 
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CHACTL (Character Control) (D401): This address writes data into the 


Character Control Register. 


Not | | | 
Used D2 D1 DO 


D2 Character Vertical Reflect Bit. This bit is sampled at the 


beginning of each line of characters. If true it causes the 
line of characters to reflect (invert) vertically (for upside 


down characters). 


Dl Character Video Invert Flag (used for 40 Character Mode 
only). If bit 7 of character code is true this flag causes 
that character to be blue on white (if normal colors are 
white on blue). 


DO Character Blank (Blink) Flag (used for 40 Character Mode 
only). If bit 7 of character code is true this flag causes 


that character to blank. Blinking characters are produced by 


setting bit 7 of the characters to 1, then periodically 
changing DO of CHACTL. 


OS SHADOW: CHACT (2F3) 


DLISTL( Display List Low )(D402): This address writes data into the 


low byte of the Display List Counter. 


Display 

7 6 5 4 3 2 7 0 List 
Counter 
Bit 


OS SHADOW: SDLSTL (hex 230) Position. 


DLISTH (Display List High) (D403): This address writes data into the 
high byte of the Display List Counter. 


Display 
15 14 13 12 ll 10 9 8 List 
Counter 
Bit 
Position. 
OS SHADOW: SDLSTH (HEX 231) 


The Display List is a list of display instructions in memory. These 
instructions are addressed by the Display List Counter. Loading these 
registers defines the address of the beginning of the Display List. (See 
sections I and II.) 


Note: The top 6 bits are latches only and have no count capability, therefore 


the display list can not cross a 1K byte memory boundary unless a jump 


instruction is used. 
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DLISTL and DLISTH should be changed only during vertical blank or with 
DMA disabled. Otherwise, the screen may roll. Bit 7 of NMIEN must be set 
in order to receive display list interrupts. 


CHBASE (Character Address Base Register) (D409): This address writes 
data into the Character Address Base Register. The data specifies the most 
significant byte (MSB) of the address of the desired character set (see 
section II). Note that the last 1 or 2 bits are assumed to be 0. 


40 Character Modes 


D7 (D6 [D5 {D4 {D3 |D2 i CHBASE 
ee seers. cpus 


ee 
15 |14 {13 [12 [11 {10 9 8 7 6 5 4 3 2 1 0 
Base Address Char Name Line Counter 


20 Character Modes 


D7 |p6 [D5 |D4 |pD3 {D2 [D1 { * CHBASE 


15 1/14 {13 312 {11 {10 9 8 7 6 5 4 3 
a 


Base Address Char Name Line Counter 


OS SHADOW: CHBAS (2F4) 


PMBASE (Player-Missile Address Base Register) (D407): This address 
writes data into the Player-Missile Address Base Register. The data 


specifies the MSB of the address of the player and missile DMA data (see 
section II). 


One Line Resolution 


D7 |D6 {D5 [D4 [D3 | not used PMBASE 

15 {14 {13 [12 [11 {10 | 9 | 8 {[/7/]6/][5/]4jj]3{/2{i1 10 

Base Address Player-Missile Player-Missile Scan 
Select | Counters 


Two Line Resolution 


D7 {D6 [D5 {D4 |pD3 {D2 i PMBASE 
Necaiciaiasieealerineieeniing -_oeeueinennean erent 
15 {14 {13 |12 [11 |10 9 8 7 6 5 4 3 2 1 @) 
Base Address Player-Missile Player-Missile Scan 
Select Counter 


at 


* = Not Used 
LI1I.6 


HSCROL (Horizontal Scroll Register) (D404): This address writes data 


into the Horizontal Scroll Register. Only playfield is scrolled, not 
players and missiles. 


not used | | | | 


0 to 15 color 
clock right shifts 


The display is shifted to the right by the number of color clocks 
specified by HSCROL for each display list instruction that contains a 1 in 
its HSCROL Flag bit (bit 4 of instruction byte). 


When horizontal scrolling is enabled, more bytes of data are needed. 
For a narrow playfield (see DMACTL bits 1 and 0) there should be the same 
number of bytes per line as for standard playfield with no scrolling. 
Similarly, for standard playfield use the same number of bytes as for the 
wide playfield. For wide playfield, there is no change in the number of 
bytes and background color is shifted in. 


VSCROL (Vertical Scroll Register) (D405): This address writes data into 


the Vertical Scroll Register. 


not used | | 


8 line display modes 


not used | | | | 


16 line display modes 


The display is scrolled upward by the number of lines specified in 
the VSCROL register for each display list instruction that contains a l1 in 
its VSCROL Flag bit (bit 5 of instruction byte). The scrolled area will 
terminate with the first instruction having a zero in bit 5. (see section 
II for more details). 


PRIOR (Priority) (DOIB): This address writes data into the Priority 
Control Register. 


D7-D6 = 0 D5 
Multiple Color Player Enable. 
This bit causes the logical “or" function of the bits of 
the colors of Player 0 with Player 1, and also of Player 2 
with Player 3. This permits overlapping the position of 2 
players with a choice of 3 colors in the overlapped region. 
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D4 Fifth Player Enable. 
This bit causes all missiles to assume the color of Playfield 


Type 3. (COLPF3). This allows missiles to be positioned 
together with a common color for use as a fifth player. 


D3, D2, Dl, Priority Select (Mutually Exclusive). 

& DO These bits select one of 4 types of priority. Objects with 
higher priority will appear to move in front of objects 
with lower priority. 


PFO PFO PO 
PF1 PF1 Pl 
Higher PO PF2 P2 


P2 


PO PFO 
Pl FF] 
P2 PF2 
P3 PF3 + 5 


P3 


PF2 
bares 


BAK 


| 
| 
| 
| 
Priority Pl |.{PF3 + P5 {._ P3 
| 
| 
| 
| 


NOTE: The use of Priority bits in a "non-exclusive" mode (more than 1 
bit true) will result in objects (whose priorities are in conflict) 
turning BLACK in the overlap region. 

EXAMPLE: PRIOR code = 1010 This will black PO or Pl if they are over 
PFO or PFl. It will also black P2 or P3 if they are over PF2 or 
PF3. In the one-color 40 character modes, the luminance of a 
pixel in a character is determined by COLPF1, regardless of the 
priority. If a higher priority player or missile overlaps the 
character then the color is determined by the player’s color. 


OS SHADOW: GPRIOR (26F) 


COLPFO - COLPF3 (Playfield Color) (D016, DO17, DO18, D019): These 


addresses write data to the Playfield Color-Lum Registers. 


| | | | | | | 
D7 | Dé | D5 | D4 | D3 | D2 | DI | DO 


(see COLBK for bit assignment) 


OS SHADOWS: COLORO — 3 (2C4-2C7) 
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COLBK (Background Color) (DOIA): This address writes data to the 


Background Color-Lum Register. 
Color Luminance 
eta acne 
D7 | D6 {| D5 {| D4 { D3 | D2 | Di |Used 


Zero Luminance (black) 


Max. Luminance(white) 


0 0 Grey 

0 0 Gold 

0 0 Orange 

0 0 Red-Orange 

0 i: Pink 

0 1 Purple 

0 1 Purple-Blue 
0 1 Blue 

1 0 Blue 

i 0 Light-Blue 

1 0 Turquoise 

1 0 Green-Blue 

1 1 Green 

1 1 Yellow-Green 
1 1 Orange-Green 
1 1 Light-Orange 


OS SHADOW: COLOR4 (2C8) 


Ee PLAYERS AND MISSILES 


DMACTL, GRACTL, PMBASE and PRIOR also affect players and missiles. 


COLPMO - COLPM3 (Player-Missile Color) (D012, D013, DO14, DO15): These 


addresses write to the Player-Missile Color-Lum Registers. Missiles have 
the same color-lum as their player unless missiles are used as a 5th player 
(see bit 4 of PRIOR). A 5th player missile gets its color from COLPF3. 


| | | | | | | 
D7 | Dé | D5 | D4 | D3 | D2 | D1 | DO 


(see COLBK for bit assignments) 


OS SHADOWS: PCOLRO - 3 (2C0-2C3) 


GRAFPO - GRAFP3 (Player Graphics Registers): (PO DOOD, Pl DOOE, P2 DOOF, 


P3 DOQ1O): These addresses write data directly into the Player Graphics 
Registers, independent of DMA. If DMA is enabled then the graphics registers 
will be loaded automatically from the memory area specified by PMBASE(see 
page II.3). 


| | | | | | | 
D7 | Dé | D5 | D4 | D3 | D2 | Di | DO 


Left Right 


GRAFM (Missile Graphics Registers) (D011): This address writes data 
directly into the Missile Graphics Register, independent of DMA. 


SIZEPO - SIZEP3 (Player Size) (PO D008, Pl DOO9, P2 DOOA, P3 DOOB): 
These addresses write data into the Player Size Control Registers. 


oral comecertial Saaee 
Used Di Register (Player) 
0 0 Normal Size 
(8 color clocks wide) 
0 1 Twice Normal Size 


(16 color clocks wide) 
1 0 Normal Size 


1 1 4 Times Normal Size 
(32 color clocks wide) 


With normal size objects, each bit in the graphics register corresponds 
to one color clock. For larger objects, each bit is extended over more than 
one color clock. 


SIZEM (Missile Size) (DO0C): This address writes data into the Missile 
Size Control Register. 


| | | | Horizontal Size 
D7 | D6 {| D5 | D4 {| D3 | D2 | D1 {| DO Register (Missile) 


Gi SS Ga Sa 
M3 M2 M1 MO 


0 0 Normal Size 
(2 color clocks wide) 


0 1 Twice Normal Size 

(4 color clocks wide) 
1 0 Normal Size 
1 1 4 Times Normal Size 


(8 color clocks wide) 


HPOSPO -— HPOSP3 (Player Horizontal Position)(PO DOOO, Pl DOO1, P2 D002 
P3 D003): These addresses write data into the Player Horizontal Position 
Register (see display diagram in section IV). The horizontal positon value 
determines the color clock location of the left edge of the object. Hex 30 
is the left edge of a standard width screen. Hex DO is the right edge of a 
standard screen. 
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HPOSMO - HPOSM3 (Missile Horizontal Position) (M0 D004, Ml D005, 


M2 D006, M3 D007): These addresses write data into the Missile Horizontal 
Position Registers (see HPOSPO description). 


VDELAY (Vertical Delay) (DO1C): This address writes data into the 


Vertical Delay Register. 


P3 P2 Pl PO M3 M2 Ml = MO 


VDELAY is used to give one-line resolution in the vertical po- 
sitioning of an object when the 2-line resolution display is enabled. 
Setting a bit in VDELAY to 1 moves the corresponding object down by one 
TV line. 


If player-missile DMA is enabled then changing the verticai location 
of an object by more than one line is accomplished by moving bits around 
in the memory map- If DMA is disabled then the vertical location can be 
set up by assembly language code which stores data into the graphics 
registers at the desired line. 


MOPF, MIPF, M2PF, M3PF (Missile to Playfield Collisions) (D000, DOO], 
D002, D003): These addresses read Missile to Playfield Collisions. 
A 1 bit means that a collision has been detected since the last HITCLR. 


Not Used | | | | 
zero forced D3 D2 Dil DO 


3 Zz 1 0 Playfield Type 


POPF, PIPF, P2PF, P3PF (Player to Playfield Collisions) (D004, 


DO05, D006, DOO7): These addresses read Player to Playfield Collisions. 


Not Used | | | | 
zero forced D3 D2 Dl DO 


3 Z 1 0 Playfield Type 


MOPL, MIPL, M2PL, M3PL (Missile to Player Collision) (D008, D009, 


DOOA, DOOB): These addresses read Missile to Player Collisions. 


Not Used | | | 
zero forced D3 D2 Dl DO 


3 2 1 0 Player Number 


POPL, PIPL, P"PL, P3PL_ (Player to Player Collisions) (DOOC, DOOD, DOOE, 


DOOF): These addresses read Player to Player Collisions 


Not Used | | | | 
zero forced D3 D2 Dl DO 


3 2 1 0 Player Number 
(Player 0 against Player 0 is always a zero). Etc. 
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HITCLR (Collision "HIT" Clear) DOLE 


This write address clears all collision bits described 


above. 
Used 
F. AUDIO 


AUDCTL (Audio Control) (D208): This address writes data into the Audio 


Mode Control Register. (Also see SKCTL two-tone bit 3 and notes). 


D7 Change 17 bit poly into a 9 bit below poly. 

D6 Clock Channel 1 with 1.79 MHZ, instead of 64 KHZ. 

D5 Clock Channel 3 with 1.79 MHZ, instead of 64 KHZ. 

D4 Clock Channel 2 with Channel 1, instead of 64 KHZ (16 BIT). 

D3 Clock Channel 4 with Channel 3, instead of 64 KHZ (16 BIT). 

D2 Insert Hi Pass Filter in Channel 1, clocked by Channel 3. 
(See section II.) 

D1 Insert Hi Pass Filter in Channel 2, clocked by Channel 4. 

DO Change Normal 64 KHZ frequency, into 15 KHZ. 


Exact Frequencies: The frequencies given above are approximate. The 
Exact Frequency (fin) that clocks the divide by N counters is given below 
(NTSC only, PAL different). 


FIN FIN 
roximate 
1.79 MHZ 1.78979 MHZ - Use modified formula for fout 


64 KHZ 63.9210 KHZ 
: - Use normal formula for fout 
15 KHZ 15.6999 KHZ 


The Normal Formula for output frequency is: 


Fout = Fin/2N 


Where N = The binary number in the frequency register (AUDF), plus 1 (N=AUDF+1). 
The MODIFIED FORMULA should be used when Fin = 1.79 MHZ and a more exact result 
is desired: 


Fout = Fin 


2(AUDF + M) 


Wheres. M= 4 if 8 bit counter (AUDCTL bit 3 or 4 = 0) 
= 7 if 16 bit counter (AUDCTL bit 3 or 4 = 1) 


4 
1 
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AUDF1, AUDF2, AUDF3, AUDF4 (Audio Frequenc D200, D202, D204, D206 
These addresses write data into each of the four Audio Frequency Control 
Registers. Each register controls a divide by "N" counter. 


Note: "N" is one greater 
than the binary number 
in Audio Frequency 
Register AUDF(X). 


AUDC1, AUDC2, AUDC3, AUDC4 (Audio Channel Control) (D201, D203 
D205, D207): These addresses write data into each of the four Audio Control 
Registers. Each Register controls the noise content and volume of the 
corresponding Audio Channel. 


Noise Content or Distortion Volume 

Divisor "N" set 

by audio frequency 

register. 

- 17 BIT poly - 5 BIT 
poly - N 

- 5 BIT poly -N - 2 

- 4 BIT poly - 5 BIT 
poly - N 

- 5 BIT poly -N - 2 

- 17 BIT poly - N 

~ Pure Tone - N - 2 


- 4 BIT poly - N 


- Force Output 


- Lowest Volume (Off) 


~- Half Volume 


- Highest Volume 
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PITCH VALUES FOR THE MUSICAL NOTES-AUDCTL =0, AUDC = hex AX 


HIGH C 
NOTES B 
A# or 
G# or 


F# or 


D# or 


C# or 


A# or 
G# or 


F# or 


D# or 


C# or 
MIDDLE C C 


A# or 
G# or 


F# or 


D# or 


LOW C# or 
NOTES C 


Bb 


Ab 


Gb 


Eb 


Db 


Bb 


Ab 


Gb 


Eb 


Db 


Bb 


Ab 


Gb 


Eb 


Db 


AUDF 


STIMER (Start Timer) (D209): This write address resets all audio 


frequency dividers to their "AUDF" value. 


These dividers generate timer 


interrupts when they count down to zero (if enabled by IRQEN). (also see 


IRQST) 


a ae 


RANDOM (Random Number Generator) (D20A): 


This address reads the high 


order 8 bits of a 17 bit polynomial counter (9 bit, if bit 7 of AUDCTL=1). 
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G. KEYBOARD AND SPEAKER 


CONSOL (Console Switch Port) (DOIF): This address reads or writes data 


from the console switches and indicators. (Set to 8 by OS Vertical Blank 
code.) 


Not Used | | | | 
zero forced D3 D2 D1 DO 


Hex 08 should be written to this address before reading the switches. 
Ones written will pull down on the switch line. 
CONSOL Bit Assignment: 


DO Game Start 


D1 Game Select - 0 means switch pressed. 
D2 Option Select 
D3 Loudspeaker - should be held at 1 


except when writing 0 
momentarily. OS writes a 
1 during vertical blank. 


KBCODE (Keyboard Code) (D209): This address reads the Keyboard Code, 


and is usually read in response to a Keyboard Interrupt (IRQ and bits 6 or 7 
of IRQST). See IRQEN for information on enabling keyboard interrupts. See 
SKCTL bits 1 and 0 for key scan and debounce enable. 


| | | | | | | 
D7 | D6 | DS | D4 | D3 | D2 | DI [ DO 


D7 
D6 


Control Key 
Shift Key 


Read by OS into shadow CH when key is hit.e The OS has a get character 
function which converts the keycode to ATASCII (Atari ASCII). 
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KEYCODE TO ATASCII CONVERSION 


epee clades, atc eames Cale Ie ste oe ae 
CODE |CAP LeCe. {U.Ce [CTRL CODE {CAP LeCe. jU-Ce {CTRL 
00 tL | 6c | 4c | oc 20 2c | 5B | 00 


wO BH 


ow 
> 
A 
~n 


OMmaVAWOANO 


2) 


men a 
3 


* = special handling 
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H. SERIAL PORT (see peripheral connector on console) 


SKCTL (Serial Port control) (D20F): This address writes data into the 


register that controls the configuation of the serial port, and also the 
Fast Pot Scan and Keyboard Enable. 


(Bits are normally zero 
| | | | | | and perform the functions 
D7 | D6 } D5 | D4 {| D3 | D2 | Dil DO shown below when true.) 
D7 Force Break (force serial output to zero (space))* 
D6 
D5 Serial Port Mode Control (see mode chart at end of 
Serial port description, page I1I.34). 


D3. Two Tone (Serial output transmitted as two tone signal instead of 
logic true/false.) 


D2 Fast Pot (Fast Pot Scane The Pot Scan Counter completes its 
sequence in two TV line times instead of one frame time. The 
capacitor dump transistors are completely disabled.) 

Dl Enable Key Scan (Enables Keyboard Scanning circuit) 


DO Enable Debounce (Enables Keyboard Debounce circuits) 


DO-D1 (Both Zero) Initialize (State used for testing and initializing 
chip) ** 


OS SHADOW: SSKCTL (hex 232) 


The OS enables key scan and debounce and may change the other bits for 
different I/0 operations. In particular, an aborted cassette operation may 
leave the two tone bit in the true state, causing undesirable audio signals. 
This may be corrected by writing hex 13 to both SKCTL and SSKCTL after doing 
I/O and/or before modifying the audio registers. 


* NOTE: When powered on, serial port output may stay low even if this bit 
is cleared. To get S.P. high (mark), send a byte out (recommend 
00 or FF). 


**NOTE: There is no original power on state. Pokey has no reset pin. 
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SKSTAT (Serial Port-Keyboard Status)(D20F): This address reads the 
Status register giving information about the serial port and keyboard. 


| | | | | | | (Bits are normally true 
D7 | D6 | D5 | D4 | D3 | D2 {| DI [ DO and provide the following 
information when zero.) 
D7 = 0 = Serial Data Input Frame Error 


D6 = 0 = Serial Data Input Over-run Latches 
must be 
D5 = 0 = Keyboard Overrun reset = l 
(SKRES ) 
D4 = 0 = Direct from Serial Input Port 
(D5 and D6 are set to 
D3 = 0 = Shift Key Depressed zero when new data 
and same bit of IRQST 
D2 = 0 = Last Key is Still Depressed is zero) 


D1 = O = Serial Input Shift Register Busy 


DO 1 Not Used (Logic True) 


SKRES (Reset above Status Register) (D20A): This write address resets 


bits 7, 6, and 5 of the Serial Port-Keyboard Status Register to l. 


SERIN (Serial Input Data) (D20D): This address reads the 8 bit parallel 


holding register that is loaded when a full byte of serial input data has 
been received. This address is usually read in response to a serial data in 
interrupt (IRQ and bit 5 of IRQST). Also see IRQEN. 


l. Clock In 2. Clock Out 

3. Data In to computer 4. GND 

5 Data Out of Computer 6. GND 

7. Command 8. Motor Control 
9. Proceed 10. +5 / Ready 
ll. Audio In 12. +12 


13. Interrupt 


See serial port description in OS manual for more details. 
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SEROUT (Serial Output Data) (D20D): This address writes to the 8 bit 


parallel holding register that is transferred to the output serial shift 
register when a full byte of serial output data has been transmitted. This 
address is usually written in response to a serial data out interrupt (IRQ 
and bit 4 of IRQST). 


Le CONTROLLER PORTS (front of console) 


PORTA (Port A) (D300): This address reads or writes data from Player 0 
and Player 1 controller jacks if bit 2 of PACTL is true. This address 
writes to the direction control register if bit 2 of PACTL is zero. I/O for 
both ports (A and B) goes through a 6520/6820 


Data Register-Addressed if bit 2 of PACTL is l. 


Joystick Operation 
| | | | | | | O=Switch pressed 
D7 | D6 | D5 | D4 {| D3 | D2 | D1 | DO l=Switch not pressed 


Right Back Right Back 


Left Fwd. Left Fwd. 
——~——_ OS 


Stickl StickO 
(Jack 2) (Jack 1) 


Paddle Operation 
| | | | | | | O=Switch pressed 
D7 | D6 | D5 | D4 | D3 | D2 | Di | DO 1l=Switch not pressed 
| L— PTRIG2 | _ PTRIGO 
PTRIG3 PTRIGL 


Keyboard Controller Operation 


Top Row 
2nd Row Jack 1 
3rd Row 
4rd Row 


Top Row 
2nd Row Jack 2 
3rd Row 
4th Row 


Direction Control Register-Addressed if bit 2 of PBCTL is 0 
| | | | | | 
D7 D6 D5 D4 D3 D2 D1 DO 


Each bit corresponds to a jack pin 


O=input 
1=output 


OS SHADOWS: STICKO (hex 278), STICK! (279), PTRIGO-3 (27C-27F 
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PACTL (Port A Control) (D302): This address writes or reads data from 


the Port A Control Register. 


| | | | | | | Port A Control 
D7 | D6 D5 | D4 | D3 | D2 { Di DO Register 
xX 0 1 1 X X 0 xX Set up register as shown 
(X = described below) 


D7 - (Read only) Peripheral A Interrupt Status Bit. Serial 
bus Proceed line. (Reset by reading Port A Register. 
Set by Peripheral A Interrupt.) 

D3 - Peripheral Motor Control line on serial bus (write). 
(0 = On 1 = Off) 

D2 - Controls Port A addressing described above (write). 
(1 = Port A Register 0 = Direction Control Register). 

DO - Peripheral A Interrupt Enable Bit. (Write) 1 = Enable. 
Reset by power turn-on or processor. Set by Processor. 


PORTB (Port B)(D301): This address reads or writes data from Player 2 
and Player 3 controller jacks if bit 2 of PBCTL is true. This address 
writes to the direction control register if bit 2 of PBCTL is zero. 1/0 for 
both ports (A and B) goes through a 6520/6820. 


Data Register-Addressed if bit 2 of PBCTL is l 


Joystick Operation 
| | | | | | 0=Switch pressed 
D7 | D6 {| D5 {| D4 | D3 | D2 | DI | DO l=Switch not pressed 


Right Back Right Back 
Left Fwd. Left Fwd. 


Se eee 


Stick3 Stick2 
(Jack 4) (Jack 3) 


O=Switch pressed 
l=Switch not pressed 


Top Row 
2nd Row Jack 3 
3rd Row 
4rd Row 


Top Row 
2nd Row Jack 4 
3rd Row 
4th Row 
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Direction Control Register-Addressed if bit 2 of PBCTL is 0 
| | | | | | | 
D7 D6 D5 D4 D3 D2 Di DO 


Each bit corresponds to a jack pin 


O=input 
l=out put 


OS SHADOWS: STICK2 (hex 27A), STICK3 (27B), PTRIG4-7 (280-283) 


PBCTL (Port B Control) (D303): This address writes or reads data from 


the Port B Control Register. 


Read Onl 
| | | | | | Port B Control 
D7 D6 D5 D4 D3 D2 Di DO Register 


x 0 1 i Xx xX 0 Xx Set up register as 
shown (X=Described 
below) 


D7 (Read only) Peripheral B Interrupt Status Bit. Serial 
bus Interrupt line. Reset by Reading Port B Register. 
Set by Peripheral B Interrupt. 

D3 Peripheral Command Identification. Serial bus Command 
Line. 

D2 Controls Port B addressing described above. 
(l= Port B Register 0 = Direction Control Register) 

DO Peripheral B Interrupt Enable Bit. 1 = Enable. 
Reset by power turn-on or: processor. Set by processor. 
(Set to hex 3C by OS IRQ code) 


POTO - POT7 (Pot Values) (D200-D207): These addresses read the value (0 


to 228) of 8 pots (paddle controllers) connected to the 8 lines pot port. 
The paddle controllers are numbered from left to right when facing the 
console keyboard. Turning the paddle knob clockwise results in decreasing 
pot values. The values are valid only after 228 TV lines following the 
"POTGO" command described below or after ALLPOT changes. 


Each Pot Value (0-228) 


OS SHADOWS: PADDLO - 7 (hex 270-277) 
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ALLPOT (All Pot Lines Simultaneously) (D208): This address reads the 


present state of the 8 line pot port. 


Capacitor dump transitors must be turned off by either going to fast 
pot scan mode (bit 2 of SKCTL) or starting pot scan (POTGO). 


| | | | | | | 
D7 D6 D5 D4 D3 D2 Dl DO 
Pot number: 
7 6 5 4 3 2. il 0 1 


Pot register value is valid. 
Pot register value is not valid. 


8 Pot Line States 


POTGO (Start Pot Scan) (D20B): 


No 
Data Bits Used 


This write address starts the pot scan sequence. The pot values 
(POTO - POT7) should be read first. This write strobe is then used causing 
the following sequence. 


l. Scan Counter cleared to zero. 
2. Capacitor dump transistors turned off. 
3. Scan Counter begins counting. 


4. Counter value captured in each of 8 registers (POTO - 
POT7) as each pot line crosses trigger voltage. 

56 Counter reaches 228, capacitor dump transistors turned 
one 


(Written to by OS vertical blank code) 
TRIGO, TRIG1, TRIG2, TRIG3 (Trigger Ports)(O DOI10, 1 DOI1, 2 DO12 


3 D013): These addresses read port pins normally connected to the joystick 
controller trigger buttons. 


Not Used | 0 
Zero Forced) DO 1 


button pressed 
button not pressed 


OS SHADOWS: STRIGO-3 (hex 284-287) 


NOTE: TRIGO thru TRIG3 are normally read directly by the microprocessor. 
However, if bit 2 of GRACTL is 1, these inputs ‘are latched whenever 
they go to logic zero. These latches are reset (true) when bit 2 
of GRACTL is set to 0. 
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PENH (Light Pen Horizontal Color Clock Position) (D40C): This address 


reads the Horizontal Light Pen Register (based on the horizontal color clock 
counter in hardware). The values range from 0 to decimal 227. Wraparound 
occurs when the pen if near the right edge of a standard-width screen. PENH 
and PENV are modified when any of the joystick trigger lines is pulled low. 


H7 H6 H5 H4& 4H3 =H2 #d4Hil_~ 4HO 


OS SHADOW: LPENH (hex 234) 


PENV (Light Pen Vertical TV Line Position) (D40D): This address reads 


the Vertical Light Pen Register (8 most significant bits, same as VCOUNT). 


LP8 7 6 3) 4 3 2 1 0 LPO not read. Two line 
resolution supplied. 


OS SHADOW: LPENV (hex 235) 


Front Panel (Controller) Jacks as I/O Parts: 


PIA (6520/6820) 
Out: TIL levels, 1 load 
In : TIL levels, 1 load 


Port A Circuit (typical): 


6520 (A) Jack 
Port 


Port B Circuit (typical): 
o+5 
4.7K 


6520 (B) 220 Jack 
Port 001 
"Trigger" Port Circuit (typical): 
CTIA Trig Jack 
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Controller Port Pinout: 


Male Female 
(console) (connector) 


Controllers 
PADDLE (POT 


HARDWARE 
KEYBOARD REGISTERS 


Bit O or 4%* 


PIN JOYSTICK 


Forward Top Row* 


Back 2nd Row* Bit 1 or 5%** 


Left A(Left)Trigger 3rd Row* Bit 2 or 6** 


Right B(Right)Trigger Bottom Row*| Bit 3 or 7** 


POT B(Right) lst Column | POT 1,3,5,7 


Trigger Button 3rd Column | TRIGO,1,2,3 


+5 +5 


GND 


POTA (Left) 2nd Column 


POT 0,2,4,6 


* Write 
*k PORTA or PORTB 
*kk STICK 0, 1, 2 or 3 


TIL. 24 


Bit O*** 
Bit 1*** 
PTRIGO, 2,4, 6 
Bit 2*** 
PTRIGI,3,5,7 
Bit 3*** 
PADDL1,3,5,7 


STRIGO,1,2,3 


PADDLO, 2,4, 6 


IV. SAMPLE PROGRAM 


This assembly language program illustrates the use of players, missiles, 
and display lists. The diagram on the next page shows what the display 
looks like and which objects are used. The comments in the program listing 
describe how it works. 
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“AT 


CHECKERS DISPLAY 


Color Clocks——————_-> 
16 32 (decimal) 


0 | 24 | 160 
 VyF NARROW SCREEN ———————_-_ 


| J ‘ t<—End of Vertical Blank 


aa eats | Bi cik eas aes iy 


24 Blank Lines 


Os Se HE pees oe 20 Characters across by 8 lines ten 
19Ss AWKIB MN rein Hi ‘rma etl bok 16 n nM ee 
41 : Lo Ha iF 


4 ei l : 


TV LINES 
AFTER 
START OF 8 Rows . 
16 Characters across by 16 lines high 
DISPLAY 
189 J . 
199. 16 Characters across by 8 lines high 
Player/ 
Missiles M2 
M3 
38 3C 5C 7C 9C BC 


Player/Missile Horizontal Position 
Register Values (hex). 


€° Al 


8802 


D409 
b466 
B22F 
DEGe 
bees 
6208 
238 
6231 
D@1D 
D407 
B26F 
8280 
D4@E 


6686 
0041 
8646 
8926 
6013 
eee1 
8690 
6919 
8626 
9038 
9048 
8050 
6864 
87h 


TITLE “ATAPI SQQ CHECKERS GISRLHY BY f 


36 ; COPYRIGHT ATARI 1920 


48 


HH 2721-720" 


56 >THIS IS AN EXAMPLE OF A DISPLAY LIST WHICH USES CHAPHCTER MAPPING TO 
66 .PRODUCE THE CHECKERS AND THE TOP AND BOTTOM BORDERS OF THE BOARD 


78 >; PLAYERS ARE USED FOR THE RED SQUARES 


€@ ;CHANGING THE COLOR REGISTERS 
36 . MISSILES 
6166 >; THE FROGRAM STARTS AT THE LOCATION SPECIFIED BY PE 


4116 
6126 
6126 
146 
158 
169 
0176 
4186 
196 
8260 
210 
6228 
6236 
8240 
8259 
6268 
8278 
9280 
290 
308 
219 
220 
6220 
@346 
359 
369 
378 
e288 
2398 
8420 
2418 
8420 
8430 
6440 
@456 
8460 


+A FEW TRICKS ARE USED TO SAVE FHI, 


ARE WSED FOF THE LEFT Ard 


FIGHT BORDERS 


THIS GIVES 6 COLORS WITHOUT 


BUT FURTHEF OPTIMIZATION IS FOSSIELE 


» THIS IS A FAM BASED PROGRAM WHICH FUNS WITH THE ASSEMBLER CARTRIDGE, NOT A 


>ROM CAR 
3; COLLEEN 
CHBRSE 
DMACTL 
SDMCTL 
HPOSP@ 
SIZEPG 
PCOLR@ 
SOLSTL 
SDLSTH 
GRACTL 
PMBASE 
GPRIOR 
VDSLST 
NMIEN 
3 DISPLAY 
INT 
JMPWT 
RELOAD 
¥SC 
HSC 
JUMP 
BLANK1 
BLANK2 
BLANKS 
BLANK4 
BLANKS 
BLANKG 
BLANK? 
BLANKS 


ruuk tte an anon 


TRIDGE. 


CATARI 800@> EQUATES 


#0483 
£0406 
£822F 
£Da80 
$0808 
$8208 
$3238 
$0231 
$D81D 
$0407 
$O26F 
$8288 
$D4G0E 


LIST EQUATES 


$86 
$41 
$48 
$20 
#18 


+ DISPLAY LIST INTERRUPT CBIT 7 OF NMI STATUS> 


+ JUMP AND WAIT UNTIL END 


OF NEXT 


VERTICAL BLANK (3 BYTES) 


3RELOAD MEM SCAN COUNTER ¢3 BYTES) 


+¥VERTICAL SCROLL ENABLE 
s; HORIZONTAL SCROLL ENABLE 


+ JUMP INSTRUCTION <3 BYTES) 


31 BLANK 
+2 BLANK 


, 


:@ BLANE 


T¥ LINE 
LINES 


TY LINES 


v°AT 


ATARI 890 CHECKERS DISPLAY BY C. SHAW 3/21/80 


8880 


8028 


8080 
9021 
8622 
4024 
8025 
8027 
8028 
8029 
802F 
3638 
Ba32 
3834 
@939 
9611 
80138 
6019 
4010 


6960 
e601 
3002 
8003 
3804 


9608 
9086 
9eCB 
saga 


84706 


8480 ; 


2498 
65988 


INTOFF = 


; 


PAGE 


$20 


3 USED TO GET INTERNAL CODE FOR UPPER CASE ALPHANUMERICS 


@516 ; INTERNAL CHARACTER CODES 


9520 
83530 
a549 
9556 
8568 
9578 
8588 
8598 
6600 
G616 
6628 
9630 
8640 
8650 
8660 
8678 
9688 
8699 
8788 
8718 


SPI 
AI 
cl 


{ss} 
- 
ee | 


¢ -INTOFF 
“A-INTOFF 
“C-INTOFF 
“D-INTOFF 
“E-INTOFF 
“G- INTOFF 
“H-INTOFF 
“I-INTOFF 
“O-INTOFF 
“P-INTOFF 
“R-INTOFF 
“T-INTOFF 
“Y-INTOFF 
“4-INTOFF 
°8~-INTOFF 
“3-INTOFF 
“@-INTOFF 


3 CHECKERS EQUATES 


’ 


3 CODES FOR SPECIAL CHECKERS CHARACTER SET 


EMPTY = 
CHECKER= 
KING 
CURS 
BORDER 


CLPS 
CLPL 
CLBOR 
PMB 


Hutu 


AWNP OD 


i EMPTY SQURRE 
3 ORDINARY CHECKER 


3 CURSOR ¢X> 
;USED FOR TOP AND BOTTOM BORDERS GF BOARD 


s3PLAYER @ CHUMAND 

+;PLAYER 1 <COMPUTER)> 

sBORDER COLOR CUSED TO SET UP 2 MSB’S OF CHAR> 
+PLAVYER MISSILE BASE ADDRESS & PROGRAM LOCATION 


C°Al 


as 
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6eue8 


46038 
5868 
5620 


9621 
9188 
5260 
5280 
523098 
5388 


5468 
5414 
5424 
S4A4 


8858 
6860 
9376 
B80 
@s9oG 
996% 
6916 
8926 
6928 
6346 
6956 
8964 
6976 
63936 
8938 
1006 
1010 
1628 
1038 
1846 
195¢e 
1068 


PAGE 
i FAM VARIAB 

“—— 
BOARD «= 
Te x= 
+ PLA'YER AND 
i; PLAYERS ARE 

Pr 
GRM@3 k= 
GRPS = 
GRP1 x= 
GRP2 “= 
GRP3 = 
TITL *= 
TOPBRD *= 
BRDSP = 
BOTBRD *= 


LES 

PME 

*+32 3 CHECKER BOARD CONLY 32 BLACK SQUARES ARE USED> 
*41 > TEMP FOR MOVING BOARD TO MEM MAP 

MISSILE GRAPHICS. 


USED FOR SQUARES, MISSILES FOR LEFT AND RIGHT BORDERS 


PMB+#188 

*+$8B ;MISSILE GRAPHICS 

*+$80 ; PLAYER @ GRAPHICS 

*+$30 3PLAYER 4 

*+$8G 3 2 

*+$8G 3 3 

*+29 3; TOP LINE OF CHARS ~-- ATASCII MESSAGE 
*+16 3 TOP BORDER OF BOARD 

8+16+*« 3 BORRD DISPLAY 

*+16 ; BOTTOM BORDER 


9° AI 
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5484 


S4B4 


5608 
S601 
5662 
S603 
Séa4 
56@5 
S606 
56867 
5668 
5609 
S60A 
Sé6é@B 
Sé6ée6c 
S68D 
S6GE 
S6@QF 
5616 
5611 
S612 
S613 
5614 
S645 
5616 
S617 
5618 
5619 
S61A 
5618 
S61C 
964D 
S61E 
S61F 
53626 
5621 
5622 
5623 
5624 
9625 
S626 
5627 


1878 
1086 


‘1Hs% 


1166 
1110 
1126 
11238 


1148 


1150 


1176 


. PAGE 

3GF -~- SPECIAL CHECKERS CHARACTER SET (ONLY CODES @-4 ARE USED> 
‘= PMb+F668 

GR 
. BYTE 8, &, 8.98.8, 0,8.6 5; BLANK ¢@)> 


. BYTE $2C. $7E. $FF. $FF. $FF. €FF,$7E,¢2C ; CHECKER (1 


. BYTE £3C. $7E. AS. $A5. $C3. $C%,. $7E, $3C > KING €2> 


. BYTE $C3, $66, $3C. $18, $18. $30. #66. $C3 ; CURSOR (23 


. BYTE @. $FF. $FF, ¢FF, FF, $FF. $FF.@ ; BORDER ¢4» 


L° Al 
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5628 


5628 
S629 
Sé2A 
562B 
S6é2C 
S62E 
S62F 
5626 


5631 
5632 
S633 
5634 
S635 
S636 
5637 
5638 
S639 
S63AR 
S63B 
563C 
S63D 
S63E 
S6SF 


5649 
S641 
5642 
5643 


5645 
5646 
5648 


564B 
S64D 
5656 
S651 


48 
AIS6 
8DO9D4 


AYZD 
8D60D4 
68 

49 


1160 
1196 
1260 
1216 
1226 
1220 
1249 
125 
1268 
1279 
1286 
1296 
1309 
1310 
1326 
1330 
1340 
1350 
1360 
1378 
1386 
1390 
1400 
1410 
1428 
14230 
1449 
1459 
1468 
1470 
1480 
1498 
1500 
1518 
1526 
1530 
15408 
1550 
1566 
1576 
1588 
1599 
1608 
1610 
1628 
1630 
1649 
1656 
1666 
1676 
1686 


. PAGE 


, 


i DISPLAY LIST 


OSP 


. BYTE BLANKS i 24 BLANK LINES 
. BYTE BLANKS 
. BYTE BLANKS 
. BYTE RELOAD+6 ; LINES @-7. MESSAGE LINE: 2@ ACROSS X 5S COLOR X 1 LINE RESOLUTION CHARACTERS 
. WORD TITL 
. BYTE INT+BLANK1 > 8. INTERRUPT TO CHANGE CHARACTER BASE ADDRESS AND CHANGE TO NARROW SCPEEN 
. BYTE 6 39-16. TOP BORDER: 16 % 5 % 1 CHARS “LAST LINE IS TOP OF 1ST ROW OF SQUARES» 
. BYTE BLANK2 317-18. TOP OF FIRST ROW OF SQUARES 
3 CHECKERBOARD (8 LINES OF CHARS WITH SPACES INBETWEEN - 22 LINES/SQUARE> 
. BYTE 7 419-34, 16XSX2 LINE RESOLUTION CHARS 
. BYTE BLANKG 535-40. FIRST 3 LINES=BOTTOM OF PREVIOUS SQUARE 
. BYTE 7 + 44-56 
. BYTE BLANKE 357-62. LAST 3 LINES=TOP OF NEXT SQUARE. 
. BYTE 7 363-78 
. BYTE BLANK6 3 79-84 
. BYTE 7 3; 85-180 
. BYTE BLANKE 3 161-166 
. BYTE 7 3167-122 
. BYTE BLANKE 3123-128 
. BYTE 7 3129-144 
. BYTE BLANKG6 3145-158 
. BYTE 7 3151-166 
. BYTE BLANKE 3167-172 
. BYTE 7 3173-188 
i NEXT THREE LINES ARE BOTTOM OF PREVIOUS SQUARE 
. BYTE BLANK2 3189-196. END OF NORMAL DISPLAY (SHOULD BE ON SCREEN ON ALL TY’S). 
. BYTE 6 3191-198: BOTTOM BORDER <MAY OVERSCAN, BUT NOT ESSENTIAL TO GAME PLAY> 
. BYTE IMPWT WRIT FOR NEXT VBLANK, THEN START OVER 
. WORD DSP 
3DSP -- DISPLAY LIST INTERRUPT HANDLER. 


i CHANGES CHARACTER BRSE AND WIDTH OF DISPLAY FOR SPECIAL CHECKERS GRAPHICS 
3 THE OS WILL CHANGE CHBASE BRCK TO NORMAL DURING VERTICAL BLANK. 


NCHRP 
PHA 


LDA #GR7256 


STR CHBASE 


; 


3 INSTRUCTION FETCH DMA ENABLE, P/M 2 LINE RES. P/M DMA ENABLE. NARROW SCREEN (128 CLOCKS> 
LDA #£¢20 
STA DOMACTL 


PLA 
RTI 


8° AI 


ATARI 886 CHECKERS 


56352 


AS2ZE 
SDZ2F B2 


908051 


ACLS 
AST4 
991354 
99A354 
88 
DOF? 


ASF 
A26AR 
991852 
999352 
991852 
999852 


DISPLAY BY C. SHAW 3731/82 


1696 PAGE 

1766 ; 

17°16 ; INITIALIZATIGN CODE -- STHFET EXECUTIGN HEFE 
17°26 ; 

1739 *z PME+4708 

1740 ; 

17586 > INIT OS°S DMACTL VARIABLE 

1760 G INSTRUCTION FETCH DMA ENABLE, F/M 2 LINE RES. P/M DMA ENABLE. 
1778 ; 

17389 LDA #*$2E 

1796 STA SOMCTL 

186e ; 

181@ ;CLEAR RAM 

1820 ; 

1830 LOR #02 

1840 TAX 

485@ INITLP 

1860 STR PMB. X 

1870 STR PMEB+$100, X 

1886 STA PMB+$200, X 

18308 STA PMB+$308. X 

1960 STA PMB+$460, xX 

1916 INK 

1920 BNE INITLP 

1930 ; 

1946 >; INITIALIZE MISSILE GRAPHICS FOR BORDERS 
1950 ; 

1968 LDR #$0E 

1978 LDY #$5E 

1986 LOQPZ STA GRNG2+$14, 4 

1996 DEY 

2686 BNE LQPZ 

2010 ; 

2028 >; INITIALIZE TOP AND BOTTOM BORDERS. 

2030 ; 

2046 LDY #16 

2858 LDA #CLBOR+BORDER 

2068 TBLP STA TOPBRD-1, ¥ 

2076 STA BOTBRD-1,.¥ 

2880 DEY 

2096 BNE TBLP s+ CONTINUE UNTIL Y=G 
2186 ; 

2110 ; INITIALIZE PLAYER GRAPHICS FOR SQURRES CCHECKER BOARD) Y=0 
2128 ; 

2136 LDR #*$FG 

2146 IN2 LDX #16 

2156 IN3 STA GRPO+$18., ¥ 

2166 STR GPP1+€18. 

2178 STR GRF2+¢18. 

2186 STR GRPS+$16, ¥ 


2196 


STANDARD SCREEN (16@ CLOCKS) 


6° AI 
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S741 
5742 
3744 
S74? 
5748 
S743 
574A 
S74C 
S74E 
5750 
S732 


5754 
5757 
575A 
5758 
S75E 
S761 
S764 
S765 


S767 
S769 
S76C 
S76E 
S771 
S773 
S776 
S778 
5778 
577D 
5739 
S782 
5735 
5737 
578A 


S730 


SVSF 
SVL 
S794 
S796 
S799 
S739A 


48 
ASBA 
999851 
68 
c8 
CA 
1BE9 
43FF 
Ce@s3 
SOEL 
Rees 


BSD857 
9906028 


99C23062 
83 
10ED 


A928 
sose02 
ASS6 
8D3102 
AIBS 
8D1D06 
AISa 
8087D4 
A914 
806F 02 
AISS 
3peae2 
AISS 
8090182 
SEGED4 


A268 


ASB1L 
3966538 
AIBL 
901450 
cA 
10F3 


2269 
2210 
2220 
2230 
2248 
2258 
2269 
2278 
2289 
2299 
2368 
23198 
2328 
2336 
2348 
2358 
2366 
2376 
2380 
2390 
24608 
2418 
2420 
2430 
2448 
2456 
2468 
2478 
2480 
24908 
2580 
25190 
2520 
2538 
2548 
2558 
2568 
2578 
2539 
2590 
2680 
2618 
2620 
2638 
2646 
2650 
2668 
2678 
2620 
2633 
2708 
2719 


3 


+ INITIALIZE 


IN4 


3 


30S. ANTIC, 


, 


3 


PHA 
LBA 
STA 
PLA 
INY 
DEX 
BPL 
EQR 
CF? 
BCC 
LDY 


LDA 
STA 
TAA 
STR 
LOR 
STA 
DEY 
BPL 


LDA 
STA 
LDA 
STA 
LDA 
STA 
LOA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
STX 


> IMNTTILIZE 


? 


BROLP 


LDX 


#2BA 


GRMBZ+$13. VY ; REST OF MISSILE GRAPHICS 


IN3 


#3FF iFILL IN OPPOSITE SQUARES 


#33 
IN2 
#3 


PLAYER AND MISSILE POSITIONS AND COLORS 


ITBL, '¥ 
HPOSP®@. Y 
3 SFF 


SIZEP@. ‘Y +; $083 INDICATES 4 TIMES NORMAL SIZE <REST IS DON’T CARED 


ITBL1, 
PCOLRG, ¥ 


INd 


POKEY INITIALIZATION 


#DSP23FF ij DISPLAY LIST START ADDRESS <LSB> 


SDLSTL 
#DSP7256 ;MSB OF ADDRESS 
SDLSTH 


#3 i ENABLE PLA'YER-MISSILE DMA TO GRAPHICS REGS. 

GRACTL 

#PMB/256 +;MSB OF ADDRESS OF PLAYER/MISSILE GRAPHICS 

PMBASE 

#514 i STH PLAYER ENABLE CUSE PF3 FOR MISSILE COLOR), PF TAKES PRIO OVER PLAYERS 
GPRIOR 30S PRIORITY REG 

#NCHRESFF i OISPLAY LIST INTERRUPT VECTOR ‘LSB? 

YDSLST 

#NCHR“256 

VOSLST+1 

NMIEN > X=SFF $C@ ENABLES DISPLAY LIST & VBLANK INTERRUPTS 
BOARD DISPLAY 


#121 


#lHECRER+CLPS ; HUMAN PIECES Ord 
ROHFD, 

#CHECKER+CLP1L . COMPUTER PIECES 
BOARD+20, 


BROLP 


SOURFES @-11 


OM SQUARES 26-31 


OT’ AI 
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2728 ; MOVE COPYRIGHT MESSAGE TO MESSAGE DISPLAY LINE 


2730 , 
SFTSl ALLS 2r4G LbY #16 
S79E BLESS? 2750 ING LDA CORY, % 
S7AL 906854 276@ STR TITL-X 
S7A4 CA 778 DEX 
S7AS 1@F7 78a BPL INE 
2790 ; 


2800 ;LOOP TO MOVE BOARD TO GRAPHICS AFEA. 
2818 ; THE CHECKERS PROGFAM LOGIC COULD BE ADDED HERE OR A VBLANK INTERRUPT COULD BE USED. 


28290 ; 
2830 LOOP 
S7A? 2OADS? 2846 JSR UPCHR 
S7AR 4CA75S7 2850 JMP LOOP 
2860 ; 
2870 ; 
2880 ; 
2898 ; 
2908 ; UPCHR -- SUBROUTINE TO MOVE 32 BYTES OF CHECKER BOARD TO DISPLAY RAM 
2918 ; 
2920 UPCHR 
STAD A2IF 2930 LDX #31 ; SQUARE 34 = UPPER LEFT 
S7AF AGGS 2948 LOY #8 
2950 UPLP1 
S7B1 AIBZ 2968 LDA #4~-41 34 SQUARRES/LINE 
SYB3S SD2658 2978 STA Te 
29680 UPLP2 
S7B6 BDeBSe 2920 LOR BOARD. xX 
S7B9 992654 26086 STA BRDSP+2.¥ ; FOR ROWS SHIFTED TO RIGHT 
S?7BC BOFC4F 3619 LDA BOARD-4., X 
S7BF 9923454 3028 STA BRDSP+219.Y ; FOR ROWS SHIFTED TO LEFT 
S7C2 Ce 3836 INY 
S7C3 C8 3646 INY 
S7C4 C8 39858 INY 
9?7CS C8 3860 INY 
37C6 CA 38678 DEX 
S?7c7r CE265e@ 32688 DEC T8 
S?CA 1GEA 3496 BFL UPLP2 
3106 ; 
SPCC 38 2118 TYR 
S7CD 16 2128 CLC 
S?fCE €918 3136 ADC ##10 
S7De AS 3148 TRY 
S704 8A 3156 TXA 
S7b2 E963 3168 SEC #4-4 3CARRY IS CLEAR <SUBTRACT 4> 
3S7D4 AA 3176 TAX 
S?7DS BDA 3186 BCS UPLFA 
S7D7 66 3198 RTS 
3260 ; 
3218 ; 
3226 i 


3230 


ITAL 
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3248 ; DATA 

3258 ; HORIZONTAL POSITION OF PLAYERS <CSQUARES> AND MISSILES (SIDE BORDERS). 
3260 ;M@=FIGHT BORCER. M1=LEFT BORDER 

3270 ;MZz & MS ARE PLACED WITH M1. 


3280 ; Po, F141, P2, P32. MG M4, Ma, M3 
3290 ITBL 
S708 3C 3380 . BYTE $3C. $5C, $7C. £9C, $BC, $38, $38, $38 
S709 Sc 
S7DAR 7C 
S7DB 9C 
S7DC BC 
S7DD 38 
S7DE 38 
S7DF 38 
3318 ; 
3326 ; COLOR TABLE 
3330 ITBLi 
S7TEO 34 3346 . BYTE $34. $34, $34. $34 54 PLAYERS CRED SQUARES) 
S7E1 34 
S?7E2 34 
S7E3S 34 
S7E4 36 3358 . BYTE $36 3PF@: RED CHECKERS AND MESSAGES 
S7ES 88 3368 . BYTE $88 3PF1i: BLUE CHARACTERS 
S7E6 GE 3376 . BYTE $GE 3PF2: WHITE CHECKERS AND MESSAGES 
STE? 26 3380 . BYTE $26 sPF3: YELLOW BORDER (CHARS & MISSILES> 
S7E8 66 33390 . BYTE @ BK: BLACK BACKGROUND 
3486 ; 
3418 ; “COPYRIGHT ATARI 1936" MESSAGE 
3420 ; 
8682 3430 OF = $0e 3FOR PF@ COLOR CRED> 
98386 3446 OF2 = $30 3 FOR FPF2 COLOR CWHITE> 
4648 34506 OFS = $46 3FOR PF1 COLOR ‘BLUE> 
3466 TGTBL 
S7TES 68 3478 COPY . BYTE SPI. C1I+0F, O1+0F. PI+OF, YI+OF, RI+OF, LI+OF, GI+OF, H1+OF. TI+OF 
SPER 23 
S?EB 2F 
S7EC 38 
SPED 39 
S7EE 32 
S7EF 29 
S?7F@ 27 
. S7F1 28 
S?F2 34 
S’FS3 AL 3488 . BYTE AIL+OF2. TI+OF2, RI+OF 2, RI+OF 2, 11+0F2, NL1+OF3, NSI+OFZ, NSI+OF3, NOI+OF3 
S?F4 B4 
S7FS AL 
S7F6 B2 
S?F? AG 
S7FS Si 
SCFS Sg 
S°rFA S58 


S7FB 50 


Vv. HARDWARE REGISTER LISTS 


Ae ADDRESS ORDER 


CTIA ADDRESSES 


WRITE READ 

Address Name Description 
DOFF 

REPEAT AS BELOW 7 MORE TIMES 
D020 
DOIF Read Consol SW. Port 
DOLE | HITCLR [Collision Clear so] 
DOLD | GRACTL |Graphic Control | 
DOIC | VDELAY |Vert. Delay =| 
D9IB | PRIOR [Priority Select | | 
DOA | COLBK |Col-lum Bkgnd |] 
D019 | COLPF3 |Color-lum of 3 | 
D018 | COLPF2 [Playfield 2 || | 
DO17 | COLPFl [Playfield 1 | 
D016 | COLPFO [Playfield OO | | 
DOL5 | COLPM3 |Color-lum of 3) | 
DOL4 | COLPM2 |Player-Missile 2 | PAL [READ PAL/NTSC bits 
D013 Read Joystick 
D012 Trigger 
DOLL Buttons 
DO1O 
DOOF Read Player 
DOOE to Player 
DOOD Collisions 
Do0C 
DOOB Read Missile 
DOOA To Player 
D009 Collisions 
D008 
D007 | HPOSM3 |Horz. Posit. Missile 3 | P3PF  —sd Read Player 
D006 To Playfield 
D005 Collisions 
D004 
D003 | HPOSP3 |Horz. Posit. Player 3 | M3PF —sdRead Missile 
D002 To Playfield 
DOO1 | HPOSP1 |Horz. Posit. Player l | MIPF —s&Y{ Collisions 
D000 | HPOSPO |Horz. Posit. Player 0 


ANTIC ADDRESSES 


WRITE READ 
Address Description 
D4FF 
REPEAT (AS BELOW) 15 MORE TIMES 

D410 

Reset NMI NMI Interrupt 
D40F NMIRES Interrupt Status NMIST Status Register 

NMI_Interru 


D40E NMI EN ENABLE Le 
PENV Vertical 


D40D 
D40C PENH Horizontal 
D40B VCOUNT Counter 


D40A WSYNC Synchronism 

D409 CHBASE Address Red 

sii ey: 
D407 PMBASE Address Register 

D405 VSCROL Register 

D404 HSCROL Register 


Display List 
D403 DLISTH Pointer (High Byte 


Display List 
D402 DLISTL Pointer (Low Byte 


Character Control 


D401 CHACTL Register 
DMA Control 
D400 DMACTL Register 


V.2 


POKEY ADDRESSES 


WRITE READ 


Name Description 


Description 


REPEAT (AS BELOW) 15 MORE TIMES 


SKCTLS Control SKSTAT 


IRQ Interrupt 
IROEN Enable > IROST 


rae <5 — ae 
SEROUT Output Reg. 
POTGO Sequence 
a a eT 
SKSTAT) RANDOM 
PN [aL PO 
AUDC4 Control POT 7 
BON [Ea hl PE 
AUDF4 Frequenc POT 6 
PO Sha Ea 
AUDC3 Control POT 5 
eT Fa 
AUDF3 Frequenc POT 4 
AUDC2 Control POT 3 
IP Fa 
AUDF2 Frequenc POT 2 
PE all 
AUDC1 Control POT 1 
PE | eal PA 
AUDF1 Frequenc POT O 


Serial Port 4 Key 
Status Register 
IRQ Interrupt 
Status Register 
Serial Port 

Input Register 


Vertical Line 
Random Numb 
Generator 


Keyboard Code 
Read 8 Line Pot 
Port State 


Read the 
value of 
each POT 


PIA ADDRESSES 


WRITE 


Address 


D3FF 
D304 
D303 


D302 


D301 


D300 


* NOTE: 


Repeat as shown below many times 


PBCTL PORT B CONTROL PBCTL 


PORTB 


PORTB 


PORTA 


PORTA 


Direction Register 
If PBCTL Bit 2-0 


Jack 2 & Jack 3 


If Direction Bits 

Are 1 * 

Direction Register 
If PACTL Bit 2=0 
Otherwise 

Jack 0 & Jack 1 


If Direction Bits 
Are 1 * 


READ 


Description 


Same as write 
Same as write 
Same as write 
Jack 2 & Jack 3 
If Direction Bits 
Are 0 * 

Same as write 
Jack 0 & Jack 1 


If Direction Bits 
Are 0 * 


Output data is retained in Jack Output Registers. 


If direction bits are true, a read of the jacks 
will read old data from these registers. 


Be ALPHABETICAL ORDER 


Name 


ALLPOT 


AUDC 1 
AUDC 2 
AUDC3 
AUDC4 


AUDCTL 


AUDF 1 
AUDF 2 
AUDF3 
AUDF4 


CHACTL 
CHBASE 


COLBK 


COLPFO 


COLPF1 
COLPF2 


COLPF3 
COLPMO 


COLPM1 
COLPM2 
COLPM3 
CONSOL 


DLISTH 


DLISTL 
DMACTL 
GRACTL 
GRAFM 

GRAFPO 
GRAFP1 
GRAFP2 
GRAFP3 


HITCLR 


HPOSMO 
HPOSM1 
HPOSM2 
HPOSM3 
HPOSPO 
HPOSP1 
HPOSP2 
HPOSP3 
HSCROL 
IRQEN 
IRQST 
KBCODE 
MOPF 
MOPL 
MIPF 
MIPL 
M2PF 
M2PL 


Hardware Register OS Shadow 
Address Address 
Dec |Name Hex}|Dec 


Description 

Read 8 line Pot Port State 
Audio Channel 1 Control 
Audio Channel 2 Control 
Audio Channel 3 Control 

Channel 4 Control 
Control 
Audio Channel 1 Frequency 
Audio Channel 2 Frequency 
Audio Channel 3 Frequency 
Channel 4 Frequenc 
Character Control 
Character base address 
Color-Luminance of Background 
Color Luminance of Playfield 0 
Luminance Playfield l 
Luminance Playfield 2 
Color Luminance of Playfield 3 
Color Luminance of Player-Missile 
Color Luminance of Player-Missile 
Luminance 
Luminance 
Console Switch Port 
Display List Pointer (high byte) 
Display List Pointer (low byte) 


755 
756 
712 
708 
709 
710 
711 
704 
705 
706 
707 


Player-Missile PCOLR3 


SDLSTH]231]561 
SDLSTL |} 230] 560 
22F 1559 


Graphic Control 
Graphics for all Missiles 
Graphics for Player 0 
Graphics for Player l 
Graphics for Player 2 
Graphics for Player 3 
Colission Clear 
Horizontal Position of Missile 0 
Horizontal Position of Missile l 
Horizontal Position of Missile 2 
Horizontal Position Missile 3 
Horizontal Position of Player 0 
Horizontal Position of Player 1 
Horizontal Position of Player 2 
Horizontal Position Player 3 
Horizontal Scroll 
Interrupt Request (IRQ) Enable 
IRQ Status 

Keyboard Code 

to 


Playfield Collisions 
Player Collisions 
Missile 1 to Playfield Collisions 
Missile 1 to Player Collisions 

Playfield Collisions 
Player Collisions 


Set to 8 during VBLANK 


Hardware Register OS Shadow 
Address Address 
Dec {Name Hex Dec 


Name Description 

M3PF [Missile 3 to Playfield Collisions 
M3PL {Missile 3 to Player 

NMIEN {Non-Maskable Interrupt (NMI) Enable 
NMIRES 
NMIST 
POPF 
POPL 
PIPF 
P1PL 
P2PF 
P2PL 
P3PF 
P3PL 
PACTL 
PAL 
PBCTL 
PENH 
PENV 
PMBASE 
PORTA 
PORTB 
POTO 
POT1 
POT2 
POT3 
POT4 
POT5 
POT6 
POT7 
POTGO 
PRIOR 
RANDOM 
SERIN 
SEROUT 
SIZEM 
SIZEPO 
SIZEP1 
SIZEP2 
SIZEP3 
SKCTL 
SKREST 
SKSTAT 
STIMER 
TRIGO 
TRIGI 
TRIG2 
TRIG3T 
VCOUNT 


Set to $40 by IRQ code 
written to by NMI code 
read by NMI code 


Playfield Collisions 

Player to Player Collisions 

to Playfield Collisions 

Player Collisions 
1 


Player Collisions 
Player to Playfield Collisions 
Player 3 to Player Collisions 

Control 


Set to $3C by IRQ Code 


Set to $3C by IRQ Code 
LPENH 234 564 
LPENV 235 565 


Port B Control 
Light Pen Horizontal Position 
Light Pen Vertical Position 

Player Missile Base Address 


632,633 
634,635 
624 
625 
626 
627 
628 
629 
630 
277 631 
WRITTEN DURING VBLANK 


wai 
232 562 


STICKO ,11278,279 


7 (right paddle controller) 
Start POT Scan Sequence 
Priority Select 
Random number generator 
Serial Port Input 
Serial Port output 
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APPENDIX A 
USE OF PLAYER/MISSILE GRAPHICS 


WITH BASIC 


The atart ® 400/800 ™ vardware Manual should be read first to understand 
the details of the Player/Missile Graphics. 


To enable the P/M Graphics from BASIC the following procedure 
can be used:* 


2% Generate the playfield, either with a GRAPHICS call or build 
a custom display list with a series of POKE statements. 


2s Enable P/M DMA control by a POKE 559 with either a 62 for 
Single line resolution players or a 46 for double line 
resolution players. 


oe There are four players and four missiles (or five players if 
the four missiles are combined into one player). Each of 
these has a horizontal position register that controls its 
horizontal position on the screen. The registers and their 
locations are as follows: 


ADDRESS HORIZONTAL POSITION OF 
53248 Player 0 
53249 Player 1 
923250 Player 2 
53252 Player 3 
53252 Missile l 
53253 Missile 2 
53254 Missile 3 
53205 Missile 4 


The horizontal positions can range on the playfield between 41 
and 200. So POKE 53249,120 will move Player 1 to the middle 
of the screen. 


*NOTE: All number references are decimal. 


Use of Player/Missile Graphics 
with BASIC, cont. 


Each player (and its missile) has a color register which 
determines its color. These registers can be controlled by 
poking to the following locations: 


ADDRESS COLOR OF 

704 P/M 0 

705 P/M 1 

706 P/M 2 

707 P/M 3 

711 fifth player (if enabled) 


Thus a POKE 706,200 will color player 2 green. 


The P/M bit information (those bytes which actually describe 
the shape of the player) must be stored in an area where it 
will not interfere with BASIC or the operating system. It 
must also start at a 2K memory boundary if single line 
resolution players are used, or a 1K boundary for double line 
resolution players. 


The page number (i.e. number of 256 byte sections of memory) 
for the starting address of the P/M information obtained in 
step 5 is poked into location 54279. 


Enable the P/M DMA by a POKE 53277,3. 


The starting address of each player is obtained by multiplying 
the number obtained in step 6 by 256 and then adding the 
offset indicated in P/M memory configuration table. 


The vertical position of the player is determined by its 
location in memory. After the initial offset is obtained in 
step 8, its height may be defined. Its range on the playfield 
is from 32 to 223 in single line resolution and from 16 to 111 
in double line resolution. By adding the desired height to 
the initial offset, the absolute address of each player is 
found. The appropriate bit information for the player can now 
be poked into this address. 


Pi: 


Use of Player/Missile Graphics 
with BASIC, cont. 


(9, cont.) 


Example to Generate a rectangular box player, eight color 
clocks wide and four lines high in immediate mode. 


STEP TYPE RESULT 

1 GRAPHICS 8 Setup Mode 8 Playfield 

2 POKE 559, 62 Enable P/M DMA single line 
3 POKE 53248,120 Set horizontal position 

4 POKE 704,838 Set color to pink 

5 I = PEEK(106)-8 Get P/M base address 

6 POKE 54279,1 Store in base register 

7 POKE 53277,3 Enable P/M DMA 

8 J =I * 256 + 1024 Get player starting address 
9 POKE J + 125,255 Draw player on screen 


POKE J + 126,129 
POKE J + 127,129 
POKE J + 128,255 


A=j= 


Suni sVOOd By bese sents S 


Use of Player/Missile Graphics 
with BASIC, cont. 


DMACTL DMACTL 
bit D4=0 bit D4=1 
start at start at 
PMBASE*102425 PMBASE * 2048.25 (. 
7 ©=— 8 Dits wide --*) *--8 bits wide -* 
384 bytes 768 bytes 
unused unused 
+384 
#512 M3 
+640 
+768 Player 1 
+896 | Player 2 M3 | M2 | M1 | MO 
+1024 Player 3 


128 bytes 
per player 


Nee eae 


double line 
resolution 


Player 0 


Player 1 


Player 3 


256 bytes 
per player 


— 


Single line 
resolution 


+0 


+768 


+1024 
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+L536 


+L 792 


+2048 
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PLAYER~MISSILE 


Memory 
Configuration 


Absolute address 
determined by 
PMBASE. 


Relative address 
shown along sides 
of maps. 


Each Player-Missile 
section (128 bytes 
in single line, 256 
bytes in double line) 
maps directly onto 
the total height of 
TV screen. 


A ~4- 


APPENDIX B 


MIXING GRAPHICS MODES 


I. GENERAL 


This procedure describes how to mix several graphic modes on 
the TV screen at the same time using BASIC commands. Each graphics 
mode has a different number of scan lines per "Mode Line™ (one line 
of a graphics mode). The TV screen must consist of 192 scan lines, 
so when mixing modes, they must be combined in*’such a way as to get 
192 scan lines. This is accomplished by modifying the Display 
List. 


When a graphics mode is set on the computer, the O/S allocates 
RAM space for the graphics mode, then builds the, display list 
adjacent to the graphics RAM, and sets a pointer to the beginning 
of the display list. Each "mode line" is constructed from a "mode 
byte" in the display list that determines how many scan lines in 
each mode line. The display list describes the screen display from 
top to bottom. 


A Display List must be built for the "max RAM mode" (the 
graphies mode that requires the most RAM) then modified with POKES 
to mix the other modes with it. This "max RAM mode" cannot be a 
split screen mode (text window), therefore "max RAM mode" +16 must 
be used. If the max RAM mode will be at the top of the screen, then 
the "LMS byte" (load memory scan byte) at the top of the Display 
List will already be correct. If not, the "LMS byte" will have 
to be modified. 


The Display List is modified by POKING a new mode byte for 
each mode line that is not a max RAM mode line. At the end of the 
display list is a JUMP instruction pointing to the top of the 
Display list. When the Display List is modified, the JUMP instruc- 
tion must be placed immediately after the last mode byte. 


Example #1 will be used throughout this procedure to 
illustrate each step. 


NORMAL | a SCREEN 


ee el 
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EXAMPLE #14 


Mixing Graphics Modes, cont. 


II. PROCEDURE TO SET UP SCREEN IN MIXED MODES: 


1. Select modes desired, then look up which mode is the max 
RAM mode from table #2. 


example: modes selected - mode 1, mode 7, mode 2 
mode 7 = max RAM mode 


2. Use table #1 to calculate the number of mode lines such 


that the total number of scan lines = 192. 
example: | | scan | 
| | lines | 
| # mode | per | scan 
mode | line | mode | lines 
| | line | 
if 6 8 48 
7 56 2 1 es 
2 2 16 32 
192 TOTAL 


3. If the max RAM mode is at the top of the screen, then skip 
this step: Calculate the LMS byte by setting the left 
nibble to 4, then use table #1 to find the right nibble for 
the graphics mode at the top of the screen. 


example: 1. left nibble = 4 
2. right nibble for mode 1 = 6 
3. LMS byte = 46 (HEX) 


4. Calculate the mode byte for each mode. Set the left nibble 
to 0, use table #1 to find the right nibble for each mode. 


example: | Left | Right! Mode 
Mode| Nibble| Nibble] Byte 
| | | (HEX) 

1 0 6 06 

7 0 D OD 

2 0 1 07 


Mixing Graphics Modes, cont. 


II. PROCEDURE TO SET UP SCREEN IN MIXED MODES, cont.: 


5- Convert all bytes to decimal. 


example: Byte (HEX) DEC 
LMS 46 70 

Mode 1 06 6 

Mode 7 OD 13 

Mode 2 07 Ul 


6. Execute a graphics call on the computer using the max RAM 
mode (+16). 


example: GRAPHICS 7 + 16 


7. PEEK the Display List pointer and use it to calculate a 
variable labelled "START". 


example: START = PEEK(560) + PEEK(561) * 256 + 4 


8. If the max RAM mode is at the top of the screen, then skip 
this step: Poke the LMS byte to location START-l. 


example: POKE START-1,70 


9. Every mode line requires a mode byte in the Display List in 
the same order as the mode lines appear on the screen. The 
mode bytes must be POKED into the Display List at location 
START + offset, where offset = mode line #. 


Example: MODE LINE # POKE INSTRUCTION 


POKE START 
POKE START 
POKE START 
POKE START 
POKE START 


MODE 1 


NUON & W NY 
+++4++ 


MODE 7 see note for mode 7 (max RAM mode) 


MODE 2 63 POKE START + 63,7 
64 POKE START + 64,7 


NOTE: The Display List will already be correct for the max RAM 
mode, therefore its mode bytes do not need to be POKEd. 


B -4- 


Mixing Graphics Modes, cont. 


II. PROCEDURE TO SET UP SCREEN IN MIXED MODES, cont.: 


10. POKE the JUMP instruction followed by the LO byte, then the 
HI byte into the Display List. The offset for the JUMP 
POKE is the last mode line # + 1, for LO byte it is + 2, 
for HI byte it is + 3. 


example: (last mode line # was 64) 


REMARK POKE INSTRUCTION 

JUMP POKE START + 65,65 

LO BYTE POKE START + 66, PEEK(560) 
HI BYTE POKE START + 67, PEEK(561) 


III. PROCEDURE TO PRINT AND PLOT IN MIXED MODES 


Ll. If the mode line #’s of a mode on the screen fall within 
the range of that mode’s normal mode line #’s then use the 
following procedure: 

a. POKE 87 with the mode # 

b.- Determine the Y coordinate by counting the # of mode 
lines from the top of the screen to the current 
position. 

ce. Determine the X position in the normal manner for that 
mode. 

d. Depending on the mode, either PLOT and DRAWTO, or 
POSITION and PRINT. 

e. These steps must be done for each mode on the screen 
that meets the condition in step l. 


example: MODE lL POKE. 87,1 
POSITION 2,1:PRINT #63"TEXT" 


MODE 7 POKE 87,7 
COLOR 1:PLOT 20,20:DRAWTO 30,30 


MODE 2 See step 2 
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IIL. PROCEDURE TO PRINT AND PLOT IN MIXED MODES, cont. 


2. Some modes may have mode line #’s outside of their normal 
range. 


example: Mode 2 normally has mode line #’s 1 through 12 
(full screen). These are modified to #63 and 
#64 in example #1. 


To prevent the computer from giving a "cursor out of range" 
error message the following procedure can be used: 
a. Set a variable labelled "MEMST" to be the display 
memory start pointer. 
MEMST = PEEK(START) + PEEK(START + 1) * 256 
b. Set a variable labelled CHRPOS to position characters 
to be printed on the target line. 


CHRPOS = MEMST + [(M, -1) *R=M, *(R-20)-M3 *(R-10)]+X 


Where: 
X = horizontal position of character on the target 
line. 


R = the RAM per line of the Max RAM Mode (table #1). 

M,= the Mode Line # of the target line. 

M,= the number of mode lines of 20 bytes of RAM per 
line above the target line. 

M,= the number of mode lines of 10 bytes of RAM per 
line above the target line. 


Example: calculate CHRPOS for Mode Line #64 (the 
last line of the Mode 2 area) at horizontal 
position 5. 


X = 5 
R = 40 
M, = 64 
MS 7 (6 from Mode 1 area, 1 from Mode 2 area). 
M, = O 


w 


CHRPOS = MEMST + [(64-1) *40=7%*(40-20)-0*(40-10)]+5 
CHRPOS = MEMST + [(63)*40-7*%*(20)-0*(30))+4+5 

CHRPOS = MEMST + [2520 - 140] + 5 

CHRPOS = MEMST + [2380] + 5 

CHRPOS = MEMST + 2385 


B ~6- 
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IIIT. PROCEDURE TO PRINT AND PLOT IN MIXED MODES, cont. 


2. cont. 

ce. If few characters will be printed, then each character’s 
internal value may be looked up in the Internal 
Character Set Table (Table 9.6), in the new BASIC 
Reference Manual. This value is then POKED into 
CHRPOS. . 

d. If strings are to be output, and if the ATASCII values 
of all the characters lie within one of the ranges 
shown in the table below, then do the following: 

1) Obtain the appropriate ATASCII value range for 
the characters 

2) Do the OPERATION the table indicates on the 
ATASCII value of each character. 

3) POKE this value into CHRPOS. 


ATASCIL VALUE | 


160-223 
224-255 


Value — 32 
NONE 


RANGE | OPERATION 
| 
0-31 | Value + 64 
32-95 | Value - 32 
96-127 | NONE 
128-159 | Value + 64 
| 
| 


Example: 1) assume we want to print the word "TEXT" 

in the mode 2 area of example #1 using 
the CHRPOS calculated previously. 

2) these characters are in the ATASCII 
VALUE RANGE of "32 - 95". 

3) the OPERATION for this range is "Value-32", 
so 32 must be subtracted from each 
ATASCII value. 

4) the program statements would now look 
like this: 


TS(1,4) "TEXT" 
CHRPOS = MEMST + 2385 


FOR X = 1 TO LEN(TS) 
POKE CHRPOS + X = l, ASC[TS$(X,X)] - 32 


NEXT X f 
(OPERATION: value - 32) 


5) the FOR/NEXT loop POKEs the first 
character of TS, ASC(TS(X,X)]-32, into 
CHRPOS + O. 

6) the next iteration POKEs the next 
character of T$ into the next CHRPOS, 
and so on. 

B -/- 


Mixin 


REMAR 
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TABLE #1 
MODE BYTE 
| | | | | SCAN | | | 
| LEFT | | RIGHT {| C.¢.] LINES | | | RAM 
K| NIBBLE| | NIBBLE| PER | PER | if | MODE| PER 
| (HEX) | | (HEX) | PIXEL] MODE | COLORS| | LINE 
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© 
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wh Ee Saat SS ae eae en cee a Ee Ne etal Nas ol a Tete Mn Oe Os, 
BLANK] O-7 | @®@ | 0 | BLANK| | | jf - 


4 SPECIAL 1 JUMP - - - Ss 


When the max RAM mode is not at the top of the screen, the 
left nibble of the LMS byte must be changed to a 4. 


Left nibble for all mode bytes after the LMS byte. 


Color & Lum for the field is controlled by Setcolor 2, and 
Lum for charactors or graphics from Setcolor l. 


JUMP - used to end the display list and return to the 
beginning. . 


BLANK - to output selected number of background lines. 
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TABLE #2 
GRAPHICS MODES 


RAM REQUIREMENTS 


Mode 8 + 16 


992 


Bytes 


These values include the display list and any imbedded 


unused memory blocks. 


OT-d 


1024 MEMORY CONFIGURATIONS 
- 
FOR MODES 0-4 
Decreasing 
RAM 
760 
54 bytes DL 56 bytes DL 
32 bytes DL 
960 
512 bytes 
character 
map 400 480 
bytes bytes 
character character 24 bytes DL 20 bytes DL 34 bytes DL 
map map 
256 
80 bytes 80 bytes 
f 160 bytes 160 bytes 160 bytes 160 160 bytes 160 
Topo yt 
F text text text bytes text bytes 
ree window window window unused window unused 
RAM 
s 


MODE: 0 1 1+16 2 2+16 3 3+16 4 4+16 


LE=a 


RAM 
Bytes 
- 8192 
Decreasing 
RAM 
6144 
4096 
2048 
Top of 
Free 
RAM 
bd 
MODE: 


MEMORY CONFIGURATIONS 


FOR MODES 5-8 
176 bytes DL 202 bytes DL 
SSeS a 
a es 
80 unused 80 unused 
94 bytes DL 104 bytes DL 
er EE 
ES (ES 
96 unused 96 unused 
94 bytes DL 104 bytes DL y 
SD Cr 
54 bytes DL 56 bytes DL —~ pos 
RE bytes 


800 bytes 960 bytes unused 
bit map bit map 640 bytes 
160 unused unused 16 unused 16 unused 


|_160text_ | i60unused | i60text[ 160unused [ ie0text_ | 160unused | 160text_ | _160unused 


5 5+16 6 6+16 7 7+16 8 8+16 


APPENDIX C: PINOUTS 


Monitor Jack (800 only) 


Di dtaN. 


Serial I/O Jack 


5 Jack 
Audio Output 3 1_,—_+—__ Composite Luminence 
Composite chromas{ 
eveuna oo Aa. Composite Video 
2 


Le Clock Input Motor Control 
2. Clock Qutput a 9. Proceed 

3. Data Input 10. +5/Ready 

4, Ground iL. Audio: Inout 
5. Data Output 12. +12 volts 

6. Ground 13. Interrupt 

7. Command 


Controller Jack 


1. (Joystick) Forward Input 6 

2. (Joystick) Back Input ve 

3. (Joystick) Left Input 8. Ground 
a. (Joystick) Right Input 9 

oe 


Trigger Input 
+5 volts 


. A Potentiometer Input 


B Potentiometer Input 


